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Foreword by Ward Cunningham 

\M ou have a thought. You want to write it down. You're thinking your com- 
r~ puter might be pretty good for that, but, surprise — it's not. 

You need two things when you want to write. You need the words to say what 
you are thinking, and you need a place to put them. 

Before wikis, computer writing was all about the words. The computer could 
help you type them, spell them, hyphenate them, size them, shape them, and 
align them. But when it came to developing your thought, well, you were on 
your own. 

Now, with wikis, you have a place to write. A wiki is a place to write in the 
same way that a party is a place to talk. There are thoughts all around you. 
Some are interesting, some less so. At a party or on a wiki, a word or two will 
be your trigger. Ideas start flowing. Talking or writing, you're among friends, 
the stage is set, you say your piece, it fits in, your words trigger the next 
thought: conversation. 

A wiki is like a party that doesn't have to stop. It's a party that doesn't get 
crowded because new rooms appear when needed. It's a timeless party 
where you can try each conversation over and over until you get it right. 

You might be wondering how a page becomes a party. Maybe you've typed 
pages and pages before, and it never seemed like fun. "Where do words go if 
not on the page?" you might be thinking. 

That's what this book explains. It shows you in plain English and with many 
examples just how powerful your computer becomes when you're at a wiki. 
Dan and Peter show you big ones, little ones, noisy ones, and quiet ones. 
They show you wikis that are for work and wikis at play. You're going to love 
this book. Party on. 

Ward Cunningham 

Portland, Oregon 
2007 
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MM yikis, born in 1995, had a quiet childhood. Now, as wikis approach their 
▼ ▼ teens, they are having a heck of a coming-out party as they are used 
absolutely everywhere for everything imaginable. Wikipedia, an online ency- 
clopedia created by using a wiki, is one of the most-used reference works on 
the planet. United States (U.S.) federal intelligence agencies — the CIA, the 
NSA, the Defense Department, and others — use a wiki to help gather, share, 
and analyze information. Google, IBM, Motorola, SAP, Sun, Yahoo!, and tens of 
thousands of other companies run important parts of their businesses with 
wikis. Hundreds of thousands of families, clubs, schools, and scientists use 
wikis for every sort of task. We even wrote this book with the help of a wiki. 
All these examples are just the tip of the iceberg when it comes to prominent 
use of wikis. 

The number of ways how wikis are being offered and hosted is also explod- 
ing. In October 2006, Google (the famous search engine company) purchased 
JotSpot, a commercially developed wiki, which will be added to Google's 
core offerings of mail, calendar, and shared documents sometime in 2007. 
WikiSpaces, wetpaint, Wikidot, Wikia, XWiki, BluWiki, seedwiki, PBwiki, Riters, 
StikiPad, Central Desktop, and others offer free, hosted wikis that are ready 
to use over the Internet. Companies such as Socialtext and Atlassian offer 
wikis that can either be installed or hosted. By far, the largest number of 
wiki sites are run by open source wiki engines, such as TWiki, MoinMoin, 
MediaWiki, and a number of others. 

Boggles the mind a bit, doesn't it? You're probably looking at this book because 
you heard about wikis and wonder whether they can help you get where you 
want to go. They can help you, and the how is really quite easy. We wrote this 
book because wikis changed our lives and how we work. With just a bit of 
effort, we suspect that wikis will do the same for you, just like they have for 
millions of other people. So read on. 



About This Book 

In Wikis For Dummies, you will find a top-to-bottom guide to understanding 
what wikis are and how to use them. Unlike many other types of technology 
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you might encounter, you need to realize that wikis aren't a product or a 
brand or a company. Rather, wikis are collections of Web pages that anyone 



k — a style of Web site invented by Ward Cunningham. This book intro- 



jliffis^^u to the basics of the style and shows how they're implemented with 
minor variations in specific products. The sorts of skills and knowledge that 
you can acquire with this book include how to 

V Edit wiki pages by using wiki markup or WYSIWYG (What You See Is 
What You Get) editors. 

v* Format the information on a wiki page. 

Link wiki pages. 

Organize the pages in your wiki so people can find them. 
Choose the right home for your wiki. 

V Attract users to your wiki. 
v* Manage your wiki. 



In Wikis For Dummies, we don't assume any prior knowledge of HTML (Web 
markup language), wiki markup, programming languages, or system adminis- 
tration skills. However, we do assume that you have surfed the Web. We also 
assume that you have a working knowledge of personal computers and have 
used browsers to go to Web sites. If you've used a Web mail system such as 
Yahoo! Mail, Gmail, or Hotmail, you'll find that editing a wiki page is just 
about the same as writing and sending an e-mail. 



By conventions, we simply mean a set of rules that we employ in this book to 
present information to you consistently. When you see a term italicized, look 
for its definition, which is included so that you know what things mean in the 
context of wiki creation and maintenance. Web site addresses and e-mail 
addresses appear in mono font so that they stand out from regular text. Wiki 
markup and HTML appear in a separate font, set off from the rest of the text, 
like this: 

+ My First Wiki Page 
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itured this book modularly — that is, it's designed so that you can 
easily find just the information you need — so you don't have to read what- 
ever doesn't pertain to your task at hand. We include sidebars here and there 
throughout the book that contain interesting information that isn't necessar- 
ily integral to the discussion at hand; feel free to skip over these. You also 
don't have to read the paragraphs marked with Technical Stuff icons, which 
parse out uber-techy tidbits (which might not be your cup of tea). 



HoW This Book Is Organized 



Wikis For Dummies is split into four parts. You don't have to read it sequen- 
tially, you don't have to look at every part, you don't have to review each chap- 
ter, and you don't even have to read all the sections in any particular chapter. 
(Of course, you can if you want to; it's a good read.) And the Table of Contents 
and the index can help you quickly find whatever information you need. In 
this section, we briefly describe what each part contains. 



Part 1: Introducing Wikis 

Part I shows you what wikis are and what they are not. You can read the his- 
tory of how Ward Cunningham created the idea of wikis and how wikis slowly 
propagated from engineering departments to the mainstream. You get your 
feet wet by seeing the basics of creating and adding content to a page. We 
then take you on a tour through examples of what wikis are used for and 
show you the most famous wiki of all — Wikipedia. 



Part 11: Making \lour Ou/n Wiki 

Part II assumes that you've gotten the bug and are ready to dive into the 
detailed mechanics of designing and creating wiki pages. No matter which 
choice you make for creating your wiki, by putting content on a wiki, you enter 
a new world. It all begins with your first page. Usually, people get started by 
going to one of the many hosted wikis described in this part. Read along there 
to follow the instructions on setting up your new wiki — there it is! A blank 
wiki page! In this part, we also give you the details of formatting wiki pages, 
linking them, and the principles of wiki design. 
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Part III focuses on meeting the challenges of promoting a wiki as well as 
choosing and installing your own wiki engine if that's what makes sense for 
you. You can read how to manage and protect your wiki as well as the possi- 
bilities for adding advanced functionality by using the structured wikis concept. 
(Structured wikis add advanced features to make wikis work like spreadsheets, 
databases, or automated tools for managing complex step-by-step processes.) 



Part IV: The Part of Tens 

The Part of Tens covers wiki attitudes and roles as well as ways how wikis are 
used at the office. This part also provides a list of innovative and exotic wikis 
that are worth a look. 



Icons Used in This Book 



For Dummies books are known for those helpful icons that point you in the 
direction of really great information. This section briefly describes each icon 
used in this book. 

Tip icons point out helpful information or key techniques that save you time 
and effort. 



Remember icons are used to note particularly important things in the text to 
greatly help you understand the technology. 



The Warning icon is synonymous with, "Hey, you! Be careful!" When you see 
this icon, pay attention and proceed with caution. 



This icon denotes that techie stuff lurks nearby. If you're not feeling very 
techie, you can skip this info. 





Introduction 



Where to Go from Here 

DropBooks. 

and 4 to 2( 



ew to wikis, read Chapter 1 to get your bearings and Chapters 3 
and 4 to get an idea of what can be done with wikis. If you want to get your 
feet wet right away, go to Chapter 2, which gets you started creating wiki pages. 

If you're pretty familiar with wikis and want to deepen your skills, start with 
the chapters in Part II. If you're running a wiki and want more advanced 
advice, Part III will be the best first stop, and you can reach back to the other 
chapters as needed. 
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In this part . . . 

;n this part, we show you the world of wikis in all its 
beauty and complexity. In Chapter 1, we explain that 
wikis are not just one product but a style of product that 
has many exemplars. You can see how and why Ward 
Cunningham invented wikis. And you can read how wikis 
are not blogs, forums, or other styles of Web sites. 

Chapter 2 is where newbies can get their hands wet 
and type an initial wiki page. Chapter 3 shows how 
wikis are used for all sorts of reasons. Chapter 4 surveys 
Wikipedia, the most famous wiki in the world. We wish 
you good wiki-ing. 



Chapter 1 

ntmrstanding Wikis: From Ward's 
Brain to Your Browser 

In This Chapter 

Finding your way to wikis 
Understanding what makes a wiki a wiki 
Comparing wikis with blogs and other Web sites 
Examining the history and future of wikis 
How to start using wikis 
••••••••••••••••••••••••••••••••••••••••••••••••a 



I MJ hen Ward Cunningham started programming the first wiki engine 
ww in 1994 and then released it on the Internet in 1995, he set forth a 
simple set of rules for creating Web sites that pushed all the technical gob- 
bledygook into the background and made creating and sharing content as 
easy as possible. 

Ward's vision was simple: Create the simplest possible online database that 
could work. And his attitude was generous; he put the idea out there to let 
the world run with it. The results were incredible. Ward's inventiveness and 
leadership had been long established by the role he played in senior engi- 
neering jobs, promoting design patterns, and helping develop the concept of 
Extreme Programming. That a novel idea like the wiki flowed from his mind 
onto the Internet was no surprise to those who knew him. 

The wiki concept turned out to have amazing properties. When content is 
in a shared space and is easy to create and connect, it can be collectively 
owned. The community of owners can range from just a few people up into 
the thousands, as in the case of the online wiki encyclopedia, Wikipedia. 
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This chapter introduces you to the wonderful world of wikis by showing you 
what a wiki is (or can be), how to find and use wikis for fun and profit, and 

,et started with a wiki of your own. We even take a brief look at some 
(futures for wikis. 



Finding \!our Way to Wikis 

How does one usually enter the wiki world? So much is made of the commu- 
nity-enabling aspects of wikis that the everyday value of wikis can get lost. 
You don't have to be on a mission to create the best encyclopedia in the 
world, build a winning startup, or organize the ideas of thousands of people 
for wikis to be useful. Wikis are amazingly helpful for simple tasks. Say you 
want to set up a carpool schedule for your hockey team, or arrange a food 
chain for a sick friend, or share ideas about the latest fashions in opening 
moves from members of your chess club. For all these scenarios, wikis 
are frequently the fastest way to do it. Part II of this book focuses on the 
mechanics of getting a wiki up and running, creating and linking pages, and 
organizing information — all the techniques and skills to serve the needs 
of individuals. 

And you can't predict what happens when a wiki hits a group of people. 
Whatever happens, though, those groups are generally never the same again 
because wikis rarely start as a top-down decision. Wikis succeed because 
someone found his way to a wiki, created some pages, and let the world 
know. A few people get the idea and start changing and adding pages. Usually, 
many others use the information on the wiki. For every one person who 
writes content on a wiki, tens or even hundreds read it. For large public wikis, 
that ratio might be more like 1:100,000. 

Wikis invade organizations when one team starts using them and then other 
teams find out about it and learn how to solve their problems with wikis. 
Pretty soon, the whole company is using wikis. Part III of this book focuses on 
the special challenges encountered when using wikis in businesses and other 
large organizations, or when a wiki created for any purpose becomes popular 
and used by thousands of people. 

No matter who you are, finding your way to wikis and figuring out how they 
can help you doesn't come by overanalyzing the subject. To get value from 
wikis, you must start putting up pages with information you want to share 
with others. Relax; making a wiki successful is not a problem that you must 
solve by yourself. Everyone you invite to use your wiki will help you get it 
right. 
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What makes a u/iki a Wiki 



phe simplest definition of a wiki that accurately captures its essence 
owing: 

A wiki is a collection of Web pages that anyone can edit. 

Several questions then follow naturally: What's on those pages? Who is 
included in the community of anyone? What will those folks be doing when 
they edit the pages? Are there any rules for how the ownership of the content 
is shared? 

And those very questions lead to the definition of a specific wiki. A precise 
general definition of a wiki is hard to come by for two reasons: 

When Ward Cunningham developed the wiki concept, he set down the 
basic ideas and let the world run with it. The world then ran in many 
directions, so each wiki engine (the program that runs a wiki; see 
Chapter 10 for more on wiki engines) works a little differently. There is 
no wiki academy that decides whether a wiki engine or a wiki is worthy 
to carry the name. 

v* The mechanisms of wikis are so simple that they make people wonder 
how such a basic set of workings can be such a big deal. The hidden 
factor is that much of the value of wikis derives not from the mecha- 
nisms but instead from the culture that seems to naturally form around 
a wiki in the people who use it. 

Ward Cunningham was interested in solving problems and sharing his ideas, 
so he didn't rush to the patent office. Rather, he put his ideas on the Portland 
Pattern Repository (http : / /c2 . com/ppr) for others to find and even 
improve. (c2 stands for Cunningham and Cunningham, Inc., which is Ward's 
company.) The brilliance (not to mention generosity) of this approach is that 
it allowed scores of wiki engines to bloom. Almost all are open source (soft- 
ware distributed for free, along with guaranteed access to the source code), 
and others are commercial software. From Ward's basic foundation, the 
idea of wikis quickly evolved, largely because of the culture of cooperative 
innovation. 



To clarify just what wikis are, we reach into our vast metaphorical toolbox for 
the best image to help you understand the mechanisms that have created so 
much excitement. Hmm, what might work? A note pad? No, that's not general 
enough. The HyperCard program? (See "The History and Future of Wikis" 
later in this chapter for more on HyperCard.) Close, but too complicated. 
Postlt notes? Nah, too sticky and too small. A pack of index cards? That's it! 
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To get going with wikis, imagine that a wiki is just a container that can hold a 
pack of index cards. 

you do with an index card container? You can 



Add new cards. 
i>* Write information on the cards. 
i>* Link one card to another. 
v 0 Sort the cards and search through them. 

Copy the cards. 

Keep track of the changes that you make to them. 



The information on each card can be plain text or text with formatting (such 
as bold, underlining, italics, or headings). You can put bullet points on cards 
as well as tables of information. 

The pages of a wiki are like the index cards in our container. Instead of physi- 
cal objects, they're electronic virtual objects created by the wiki engine. 
Figure 1-1 shows a wiki page that we used to keep track of this book while it 
was being written. 



Figure 1-1: 

This wiki 
page was 
used while 
writing 
Wikis For 
Dummies. 
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One of the most important aspects of wiki index cards is that they can be 
linked. One card (or page, or whatever you want to call it) can easily refer to 
a^To jump to a linked card, you simply click a link, just like you move 
^any other Web site. Cards can even be linked to other cards that 

yet exist. When you click a link to a card that doesn't exist, the wiki 

engine creates it; then, you can add whatever you like and save it. 



DropBoat 

rinn't 




The ability to handle partially completed content by putting in links to topics 
(covered later) is one of the most powerful aspects of wikis. It allows your 
thoughts to flow and to easily keep placeholders for issues to which you 
want to return. 



If you think of all these cards in a central place where anyone can go and look 
at them and (this is the important part!) change them to add their two cents, 
then you are on to the secret sauce of wikis and are ready to begin using and 
contributing to wikis yourself. A whole new culture is created as people work 
together to build and improve a wiki. This value of shared content ownership 
is quite powerful. It allows people to use their special knowledge to correct 
each other and to complete thoughts and ideas started by others. 

But wait, you must be thinking, there must be more to it. A simple little 
Microsoft Access or MySQL database can do all those index card things. Yes, 
there is more to it — or actually, less to it. The reason why wikis are as popu- 
lar as they are is that creating and editing content on a wiki is easy, easy, 
easy. That's why wikis have succeeded. The idea of a shared online database 
is not unique, but the quest for an easy-to-use computer program is rarely 
realized. An easy-to-edit, shared online database of pages that really works? 
That's a wiki. 



Comparing Wikis and other 
communication toots 

One of the fastest ways to improve your understanding of wikis is to see how 
wikis are different from many other tools for Internet-based communication 
such as e-mail, blogs, bulletin boards, forums, content management systems, 
and Web publishing systems. 

Wikis are toolkits for creating pages. The pages created can work in many dif- 
ferent ways. This is key to understanding the differences between a wiki and 
other forms of Web sites and tools for collaboration. 

i>* Wikis are not e-mail. Individual e-mails share some wiki properties — 
they are easy to create, they can be quickly formatted, and almost 
anyone can create an e-mail. And, e-mail can also be used for one-to-one 
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or many-to-many communication by sending mail to many people or by 
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using mailing lists. However, e-mail lacks a central place where everyone 
work at once. And e-mail also doesn't allow many authors to work 
e same page or for pages to be linked. E-mails are also usually short 
whereas wiki pages can be as long as needed. 



v 0 Wikis are not blogs. A blog is a set of pages on which short entries are 
posted, usually appearing in a list with the most recent entries on top. 
Comments can appear attached to each posting. RSS (really simple syndi- 
cation, a format for live online data feeds) feeds allow people to be noti- 
fied when new blog content appears. (Note that RSS feeds can apply to 
any sort of content, but they seem to be wildly popular with blogs.) 

Wiki pages can be made to look like blog pages, but they don't come out 
of the box with all the pages needed to automatically write and publish 
blog entries. Blogs are usually focused on one-to-many communication, 
but wikis are more oriented to many-to-many communication about 
shared content. 

i>* Wikis are not bulletin boards or forums. Bulletin boards (sometimes 
called forums') are Web pages where you can ask a question, make a com- 
ment, or put forth a proposition to which others can respond. The list of 
comments about a topic appears in a long list of entries, which some- 
times branches into subtopics. 

Bulletin boards are more focused on many-to-many communication than 
blogs but in a way that is more structured than wikis. Wiki pages can be 
used like bulletin boards in a style called thread mode, in which new 
comments are added to the bottom of a wiki page, but this is a style (not 
a structure) that is enforced by the wiki. In bulletin boards, the structure 
of the pages and the communication are always the same and cannot be 
changed by the people using the board. 

i>* Wikis are not content management or Web publishing systems. 

Content management and Web publishing systems are general purpose 
engines for creating all sorts of Web sites. Like wikis, content manage- 
ment systems are toolkits; unlike wikis, though, they aren't governed by 
the rules that Ward Cunningham set down for what wikis are. 

Almost any kind of Web site, blog, bulletin board system, and wiki can be 
built by a content management system. Many content management sys- 
tems have extensions to allow wikis to be included in the Web sites that 
are built. Usually, content management systems can only be used by 
expert programmers, but wikis can be used right away by almost 
anyone. 



The (almost) format definition of a Wiki 

In the preceding section, we determine that wikis aren't e-mail, blogs, bulletin 
boards, or Web publishing systems. So what are wikis, exactly? 
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One of the reasons why wiki engines went off in many different directions 
is that Ward Cunningham didn't define wikis too tightly, and he set nothing 
However, the first wiki that he created at the Portland Pattern 
ry had a bunch of features that have become so widely imitated 
that they became the de facto definition of wiki. In our opinion, for a wiki 
to be a wiki, it must have the following characteristics: 

V The pages must be stored in a central, shared repository. The wiki 
should be located in one place to make it easy to share. 

Anyone should be able to edit pages. Wikis are flexible, which means 
the organization of the information on each page can be changed as 
needed and not just by an expert or an administrator. 

C" Editing should be easy and accessible and not require special tools. 

The wiki should be simple, making getting started easy. Wikis are easy to 
master, which allows other people to join in and create pages. 

Formatting information pages should be much simpler than using 
HTML. Table 1-1 shows how much simpler it is to create links (see the 
following bullet) and bullets in a typical wiki than in HTML, the language 
used to program most Web pages. 

Linking one page to another should use WikiWords or use a technique 
that is just as easy. See Chapter 7 for more on WikiWords and creating 
links in wikis. 

A list of recently changed pages should be available. 



Table 1-1 




Wiki Markup versus HTML 




TWiki.org 


HTML 


Creating 
links 


ThisIsALink 


<A HREF= " ThisIsALink . HTML " > 
ThisIsALink</A> 


Creating 
bullets 


* A bullet 




* A sub- 


bullet <ul> 

<li>A bullet</li> 
<ul> 

<li>A sub-bullet</li> 

</ul> 

</ul> 



No formal standard for wikis exists like the standards that are used for HTML. 
HTML (HyperText Markup Language) is controlled by an official standards 
body that changes the standards for HTML according to a public, collabora- 
tive process that is governed by a set of rules. Lots of people have said that 
creating a standard for wikis would be a good idea, and many proposals have 
been made for standardizing various aspects of wikis, but none have taken 
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hold. Given the fact that the idea of wikis is not controlled by anyone, a stan- 
dard is not likely to emerge any time soon. The definition of wikis used in this 
epresents the true spirit of wikis, although like with any community 
a thousand anythings have bloomed, some people are sure to dis- 
agree. No doubt they will say so on their wiki — or more likely, on their blog. 



Having no set standards for wikis doesn't mean that wikis haven't evolved. 
Several innovations created since the first days of wikis have become part of 
almost every wiki engine: 



V Versioning: Saving a version of each wiki page so that previous versions 
can be referred to or restored 

v 0 Attaching files: Allowing files to be attached to wiki pages 

Backlinks: Allowing easy browsing of all pages that link to a certain page 

v* Notification of changes: Alerts sent when a page has been changed 

i>* Searching: Offering some way to enter words to search for in wiki pages 

V* Printable pages: Creating a printable version of a page that takes out the 
navigation 

It is only fair to point out that printable pages were not invented by wiki 
developers. This innovation occurred in many different types of sites, but it 
is now a standard feature of almost every wiki engine. 



l/ou, Too, Cart Wiki 



So, you must be thinking, "Let me have at a wiki! I want to see what it's all 
about. How can I get started?" But another part of you must be thinking, "If 
wikis are so great, why don't more people know about them? Why aren't 
more people using wikis?" It turns out that understanding the second ques- 
tion is key to making progress with the first. 



Starting your utiki engines 

The growth of wikis was severely limited up until 2006. Before then, the only 
way you could use a wiki was to first set up a wiki engine on a server. This 
meant that to use a wiki, you had to have access to a server that was avail- 
able through the Internet as well as the skills to set up and run a wiki engine. 

For most people, these barriers were insurmountable. And even if someone 
had the skills, he had to have access to a server connected to the Internet. In 
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engineering organizations, this is almost always no problem. Servers and 
skills to set them up abound. That is one reason why wikis have been so pop- 
gineering organizations and generally scarce everywhere else. 



But from 2004 to 2006, something dramatic changed. Entrepreneurs noticed 
the market opportunity for providing hosted wikis (also known as wiki farms) 
that allowed people to create wikis without needing their own server or spe- 
cial skills. With a hosted wiki, anyone can get started right away. All you need 
to know is how to create and edit wiki pages, which is much easer than set- 
ting up a wiki engine. 

JotSpot, WikiSpaces, Wikia, PBwiki, XWiki, BluWiki, and Fluxent (to name just 
a few) all offer hosted wikis, mostly based on open source software. Google's 
entry into the field with its purchase of JotSpot will dramatically widen the 
awareness of wikis. 

The great thing about hosted wikis is that you just have to sign up to start 
working. What sometimes bothers people about hosted wikis is that you have 
to sign up for an account, which means keeping track of yet another login and 
password. To make money, hosted wikis usually either have on-page advertis- 
ing, or they have some sort of per-user charge that hides advertising and/or 
gives access to premium services. 



Creating your first u/iki page 

The best way to start wiki-ing is to find an existing wiki (that is, a hosted wiki) 
and start adding to it. To start creating your first wiki page, you can go to any 
of the wikis in this list: 

http : / /wikis fordummies . pbwiki . com 
http : / /wikisf ordummies . wikispaces . com 
\^ http : / /wikisf ordummies . xwiki . com 
http : / /wikisf ordummies . wetpaint . com 
http : / /wikis- for- dummies -swicki . eurekster . com 

Each of these wikis was set up at a different hosted wiki provider to allow 
readers of this book quick access to page creation. Go to any of these Web 
sites, and you will see a prominent link to a sandbox page of the sort shown in 
Figure 1-2, which shows the page on http: / /wikisf ordummies .pbwiki . 
com. A sandbox is a practice page on a wiki where you can go to play around 
and become familiar with the ways of the wiki. Click the Sandbox link to go to 
a page that looks something like Figure 1-3. 
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Figure 1-2: 
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Figure 1-3: 
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A generic sandbox page allows you to create your first wiki page. To create a 
page at PBwiki, follow these steps: 



the Edit Page button. 

2. Enter the PBwiki password, which is wikis4dummies. 

After you enter the password, you see a page that looks like Figure 1-4. If 
it doesn't look like Figure 1-4, click the Switch to Classic Mode link in the 
upper right of the window. 

3. At the end of the list, enter a name for your reader page in camel 
case, something like TestPage. 

Camel case is a way to capitalize words, using capital letters in the 
middle of a word, to indicate that the word is a link to a page. 
MyTestPage, ThisTestPage, and a TestPage are all camel case and would 
be recognized as links by most wikis. For more on using camel case, see 
Chapter 7. 



Figure 1-4: 
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You see a link that reads TestPage. The name is underlined with red 
es to indicate that it has not yet been created. When you click 
tPage, a page appears asking whether you want to apply a template 
or change the name of your page. Don't change its name. (And for now, 
skip the template — come back later and be adventurous.) 

5. Click Create New Page. 

You see a new page into which you can enter text. This is your first wiki 
page. Play around, have fun. Don't worry. You can't break anything. 

In other wikis, pages that are inserted as links but have not yet been created 
are indicated in other ways. One common method places a question mark at 
the end of the name of the page like this: TestPage? 

If you feel ready, you can create an account on any of the hosted wikis listed 
here and start creating your wiki right away. Chapter 5 explains how to find a 
home for your wiki. Chapters 6, 7, and 8 cover how to create content, link 
pages, and design your wiki. 



Wabi-sabi: The beauty of unfinished content 



Wabi-sabi is one of the most important attitudes 
to embrace as you start entering the world of 
wikis. Most of us are nervous about putting 
incomplete work in a public place. For wikis to 
work, though, this has to happen. One of the cul- 
tural aspects that wikis embrace is the value of 
unfinished or half-finished content. One of the 
reasons why ideas can flow so quickly when 
creating content in a wiki is that links to wiki 
pages can serve as placeholders for laterthink- 
ing. When you move through capturing an idea, 
you can write about the idea you have; when a 
complex problem comes up, you can just put a 
linkto a wiki page that you plan on creating and 
continue with the flow of your thoughts. Then, 
you or someone you're working with can then 
use that link to the new page as a way to build 
on the initial ideas. In wikis, the idea of one 
author is shattered. Because of this, unfinished 



content ends up being encouraged because it 
provides the opportunity for other authors to 
come in and help finish the job. 

Wabi-sabi is a Japanese expression that 
roughly translates to the "beauty of things 
imperfect, impermanent, and incomplete." It is 
the beauty of things modest and humble. Itisthe 
beauty of things unconventional. Observe a 
ceramic cup for a tea ceremony, for example. It 
might have rough edges, an irregular shape, 
and glazing that covers only half of the cup. This 
cup represents the content you initially puton a 
page, in rough shape, without finishing touches. 
Unlike a tea cup though, a wiki page may and 
will change overtime. Share content often and 
early, and people will participate and help 
improve the content. 
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have a home for your wiki, the fun begins. Wikis reward action and 
participation. Here's the wrong approach: Spend huge amounts of time plan- 
ning what will be on your wiki and deciding how people will use it. The right 
approach: Get content up on the wiki and show people how they can change 
and improve it. Hand them this book, for example. What happens then is that 
the nerds come out. You will know them by their sense of excitement and by 
how much they write on the wiki. 

Of course, certain patterns and structures work really well on wikis. And 
wikis can and should be designed for certain purposes. Content-focused wikis 
are all about a subject or many subjects. For example, Wikipedia is a content- 
focused wiki. Process-focused wikis are wikis that are focused on getting some- 
thing done, like managing a project or writing a book. Community wikis bring 
a group of people together based on a shared interest. And ease-of-use wikis 
are for people who just want to put up a Web site the easy way: for example, 
to share family photos or create a quick brochure. In Chapter 3, we cover all 
these types of wikis. The type of wiki should influence the wiki's design. We 
cover many different design ideas in Chapter 8. The most important thing is 
to get people on the wiki. We explain the tricks and techniques for that in 
Chapter 9. 



Who are uriki people) 

To make wikis successful, you need to understand the conditions under which 
wikis thrive and the sorts of people who use them. 

It is no accident that wikis had early success among engineers, and then next 
among the sort of writers/editors who make Wikipedia happen. Wikis are 
about sharing knowledge; to do so, you have to have enough passion to actu- 
ally sit down and communicate your ideas. Writing is one barrier, and putting 
your ideas out there for others to see can also be scary. Who does this sort 
of thing? 

Knowledge nerds, that's who — nerds whose passion for knowledge over- 
comes most everything else (like taste in clothes, for example). There are 
engineering nerds and word nerds, law nerds and math nerds, medical nerds 
and music nerds. You get the idea. Nerds know things and want to spread the 
message. So, a wiki won't work unless you have passionate nerds somewhere 
in your organization who want to get their knowledge out. 
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For those who think we're kidding or that we're a few cards short of a full deck, 
we're not. In most wiki environments, the key thing that happens is that some- 
wants to share information or get everyone on the same page — and 
are willing to spend time to make it happen. That person is the wiki 
champion, and he or she eventually becomes the wiki coach. (See Chapter 16 
for descriptions of the various roles people play in wikis.) After that person 
makes a stand and gets a wiki engine going, a committed group of others needs 
to join in and start creating and sharing knowledge, or else the wiki withers and 
dies. The reason why wikis are such a big deal is that they uncover the nerds in 
an organization who want to make a difference; by sharing knowledge, they can 
make that difference. 



Everyone need not be a nerd for wikis to succeed. There just needs to be 
enough nerds to make the wiki useful. For every nerd, 20, 40, or perhaps 60 
other people benefit from the information just by clicking through the wiki 
and seeing what's there. 

The first things to ask yourself when you set out to introduce a wiki into an 
environment are: Who will join me in sharing knowledge on the wiki? Who 
has the passion? Do we really have enough wiki people to make this work? 



The lifecycle of Wiki people 

The natural lifecycle of the wiki person is another useful thing to keep in 
mind as you discover how to make wikis a part of your life. How fast you 
move through this lifecycle when you encounter a wiki is usually a good indi- 
cator of how important a wiki is to you. Some knowledge nerds go from a 
reader to a champion in a matter of days, and the wiki concept makes their 
brain rage with possibilities. 

The first way how most folks start using a wiki is as a reader. You go to a wiki, 
see the content, and enjoy it. That might just be enough. Many people who 
regularly use Wikipedia have no idea that it is a community-created resource 
that they could get involved with if they wished. 

The big first step for most wiki users is to actually reach into a wiki and 
change some content to improve it. You see something incorrect, and you 
want to fix it. When you do this, you have become an editor. Although this 
sounds like a simple act, it has an unusually large emotional effect. After you 
change content, it no longer belongs to all those other people: It becomes 
partially yours. As every writer knows, the pleasure and pride of authorship 
is a satisfying reward. 
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After you join the community of authors of a wiki, it doesn't take long for 
your imagination to lead you to ways to extend the wiki by creating content 
rs new areas. You have progressed to become a contributor of a 
w chunk of content that may be corrected by others. 



Although many wikis start out as self-organizing communities where every- 
one just takes care of what needs to be done, certain roles and processes nat- 
urally develop. As you participate and lead these activities, you become a 
manager of a wiki. (Chapter 12 covers the typical wiki management tasks.) 

The final step in the lifecycle of a wiki user is recognizing that a new wiki is 
needed to meet your needs or the needs of a community to which you 
belong. By starting a new wiki, you become a wiki champion and bring the 
benefit of wikis to others. 



Herding a smail group With Wikis 

The first thing that generally happens with a wiki is that a small group starts 
using it for project management or to jointly create some sort of content. For 
project management, the wiki becomes a repository of lists, notes, schedules, 
and documents, all keeping the state of the project up to date. As an example, 
this book was written using a wiki to coordinate the activities of everyone 
who worked on it. Content creation can encompass documenting require- 
ments for a software program, writing a policy-and-procedure manual, or col- 
lecting and posting research. It could be anything. 

The first project on the wiki leads to the second and the third, and the group 
of wiki users starts growing. As the user base grows, you have to be more 
methodical about running your wiki. You then need a more structured, wide- 
body wiki. 



Wide-body Wikis for your company 

If a small-scale wiki works for you, pass Go, collect $200, and roll it out com- 
pany-wide. If you're not just creating an interesting collaboration environ- 
ment for a few folks but changing the entire culture of your company, 
however, that requires more planning. It's not that the use of the wiki 
becomes restricted, but the support activities must be planned for. The idea 
is not to force a specific wiki solution on people but to teach them to put 
wikis to work by themselves. Wiki coaches must be trained so that each 
group using the wiki has someone to turn to. System administrators must 
be trained to perform tasks such as setting up new webs, managing user 
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accounts, and archiving old content when necessary. Chapter 13 of this book 
covers all these issues related to the care and feeding of wikis. 



mpany has become wiki-wise, the more advanced uses of struc- 
tured wiki applications might make sense. Structured wikis are described in 
Chapter 14. Although the fundamental transformation of the workplace 
occurs through basic wiki functionality, structured wiki applications can be 
a huge boost to productivity. Structured wiki applications help track and 
automate flexible processes that combine both structured and unstructured 
elements. 



Going public With your Wiki 

In the first years of wikis, much of the action in wikis took place within corpo- 
rations and other large organizations. The rise of Wikipedia and hosted wikis 
shows that wikis can organize large groups of people quite effectively outside 
of an organizational context. Some companies try to use wikis to communi- 
cate with customers. Activists use wikis to organize people for social change 
or to create special kinds of content. In Chapter 9, we cover wiki evangelism 
and explain the different ways how people carry the message of wikis to new 
domains. 



The History and Future of Wikis 

So far, the idea of wikis has been explained from the general to the specific: 
from the outside-in, is one way to say it. To better understand the essence of 
wikis, understanding wikis from the inside-out is also useful. How did the idea 
originate? What was Ward Cunningham's mission when he developed the wiki 
concept? What were the false starts? How did the idea of a wiki flower into 
being? The following sections explore some of the history behind wikis as 
well as the directions in which they might go. 



HyperCard and other Wiki precursors 

You can find many wiki-like things in the past. For example, Tornado Notes, 
which became InfoSelect, was a database of free-form notes. And FolioViews 
made it easy to link between pages. Of all the precursors, HyperCard is prob- 
ably the most wiki-like thing that existed before wikis. HyperCard was a pro- 
gram created by Bill Atkinson for organizing information; when it came out in 
1987, it was distributed with every Macintosh computer sold. 
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HyperCard used the metaphor of index cards and stacks of cards. On each 
card, fields of information could be stored, text could be entered, and cards 
linked. Boy, this sounds a lot like a wiki. What wasn't wiki-like 
jjHperCard was that it was not on the Web. In their first incarnation, 
HyperCard stacks could be used on a single computer or a bunch of comput- 
ers sharing a file system where a common stack could be accessed. Still, 
HyperCard stacks weren't created to allow anyone on the Internet to be able 
to access them through a browser. This is a big difference from wikis. 

The other thing about HyperCard was that it was sort of a programmer's tool. 
It was easy to use, but when you wanted to link one card to another, you had 
to go through some rigamarole, like starting at the card to which you were 
linking, jumping to the card from which you were linking, and then planting 
the link there. The rest of HyperCard was a pretty cool programming environ- 
ment, but it wasn't very easy for normal people to use. This is another big dif- 
ference from wikis. 



Of course, the biggest and most influential predecessor of wikis is the World 
Wide Web. Without Web sites and browsers to provide easy, universal acces- 
sibility, wikis could not exist. The World Wide Web introduced the linking and 
browsing paradigms now found in wikis. 



Ward's challenge 

The unusual aspect of the development of wikis is that Ward Cunningham 
didn't set out to create wikis. Ward's goal was to share information. In 1995, he 
was deeply involved in the consulting firm Cunningham and Cunningham, Inc., 
working with other people on developing the idea of Extreme Programming (a 
radical restructuring of the process of creating software), and also developing 
the concept of reusable patterns in software development. 

The itch that Ward wanted to scratch was to create a repository of patterns 
that other people could see and modify as well as supplement with their own 
patterns. The idea was to create a shared space that allowed people to com- 
municate and collaborate about this nifty idea of patterns. 



Ward's solution 

As Ward Cunningham pondered the challenge of easily sharing information, 
the stars started to align. As an accomplished programmer, Ward knew how 
to write programs for the Web. As a seasoned developer and as someone who 
really wanted to get others interested in patterns, Ward was suspicious of the 
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idea that just writing any old script that imitated traditional approaches 
would actually solve his communication problem. He knew that his solution 
easy to use and accessible to everyone without much effort. 



So, by using the Perl scripting language, Ward at first created a system that 
was a database of pages. Then he figured out a way to edit those pages in a 
browser window. Web browsers were spreading like wildfire, and making edit- 
ing happen through a browser window meant that everyone could use his 
repository without much effort. 

But then he had to figure out how to make the information on the pages look 
good, convey information, and (most of all) link to other pages that were 
related. Again, Ward felt that all this had to be much easier than existing alter- 
natives like HTML, which is why the simple markup language was invented. 

After Ward got his ideas working, he went back to his work of creating pages 
about patterns. It was like falling downhill. What took two hours or longer in 
HyperCard could be done in 10 or 20 minutes or even faster. In about three 
hours, Ward had 15 or 20 pages done. 

The only thing left was the naming. Ward first considered using the word 
Quick. A product called Quick Basic already existed (an easy-to-use form of 
the BASIC language), and Ward considered using the name QuickWeb. That 
seemed about as exciting as cold oatmeal. Ward then remembered that wiki 
wiki means quick in Hawaiian, and he called his invention the WikiWikiWeb, 
which eventually got shortened to wiki. 



The not'So-oVemiqht success of vOikis 

Wikis gradually took hold over the 1 1 years following Ward Cunningham's 
development of his first wiki engine, called WikiBase. During that time, the 
concept was expanded by the open source community. Wikis became popular 
with one group, then another, and eventually began invading the mainstream. 

It didn't take too long for wikis to be noticed by developers in the open source 
community. What happened was that many people discovered — surprise, 
surprise — that Ward hadn't thought of everything. This, of course, was no 
surprise to Ward, who assumed that he hadn't thought of everything and was 
eager to see what other people would think of. 

If you ever go to the Portland Pattern Repository front page (http : / / 
c2 . com/ cgi /wiki), you might be surprised at how bare-bones it is com- 
pared with other wiki sites you may have visited, such as www . wikipedia . 
org. What Ward created was the dune buggy of wikis. Some features added 
by the open source community include 
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i>* Version control: The ability to save every version of a page and go back 
to previous versions as needed. This is important because so many 
le might change a page; see Chapter 13 for details. 



'ess control: The ability to control who accesses the wiki and what 
they can do; also covered in Chapter 13. 

Plug-ins for added functionality: The ability to add in any other kind of 
functionality that might be needed. See Chapter 14 for some great exam- 
ples of plug-ins. 



Wikis lurk in the realm of the engineers 

As the number of wiki engines grew, the concept became extremely popular 
in engineering, technology, and software development companies. Here are 
some reasons why: 

Engineers are early adopters of anything cool. 

f* To get a wiki running in the early days, you had to have access to a 
server and know how to set up a wiki engine. Engineers had these skills. 

i>* Even though wikis were easy for anyone to use, engineers found them 
ultra-simple. Some aspects of a wiki, like the simple markup, never pre- 
sented a problem for engineers even though they could seem somewhat 
scary to newcomers. 

Wikis were incredibly flexible in how they could represent different ways 
to organize information. Engineers love taxonomies, which are different 
structures of information. (We discuss taxonomies in Chapter 8.) That a 
wiki could organize information many different ways at the same time 
seemed cool to an engineer. 



The open source roots of wikis 



Almost all early implementations of wikis were 
open source, which is one of the reasons why 
so much experimentation took place about the 
right way to build a wiki engine. Wikis have suc- 
ceeded because in many ways, they bring the 
open source values of shared ownership and 
rapid-fire experimentation to the world of col- 
laboration, content creation, and knowledge 
management. The fact that so many early wikis 
were open source eased the way for the prop- 
agation of wikis in so many different kinds of 
organizations. After the ideas of wikis were in 
tens of thousands of brains, ideas like Wikipedia 



and other innovative uses sprang up. Now that 
the idea of wikis has become so popular, entre- 
preneurs have created commercial versions of 
wikis with special features that are not shared. 
Although some resent this commercialization as 
a form of robbery of ideas that were in the 
public domain, others (including us) see the 
emergence of commercial wikis as confirmation 
that wikis are here to stay. It is clear, though, 
that the road to this success could not have 
happened without the structures and values of 
open source showing the way. 
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So, at many of the biggest companies in the world — such as Sun 
Microsystems, the German software maker SAP, and Motorola — and at 

er companies all over the world, wikis became the central nervous 
11 the while lurking in relative obscurity. 



Wikis grovl beyond engineering 

The next wave of wiki expansion occurred as awareness of wikis grew organi- 
cally inside companies. An engineer would show someone from marketing 
the requirements for a new system on the wiki. They would discuss it, the 
engineer would just edit the page to change the requirements, and perhaps 
an e-mail would be automatically sent out notifying everyone on the team 
that something had changed. 

The marketing person would look at this and say, "Dude, this is pretty darn 
useful. How can I get one of these for my projects?" 

In this way, the marketing department and eventually other departments 
overcame the technical barriers that stopped them from using a wiki by 
themselves. They couldn't set up a wiki engine. They had no skills to do so. 
They had no servers on which to put a wiki engine. But the engineers did. 

Many an engineer became an unofficial wiki champion, leading the way in the 
use of wikis. They would set one wiki up for one team, and that team would 
use it with another, who would want their own, and then the cycle would 
repeat until lots of people were using this really easy project management 
tool without ever knowing that it was a wiki. 

The other way awareness of wikis expanded was the growing momentum 
behind Wikipedia, which was founded by Jimmy Donal Wales (who had started 
an earlier version of an online encyclopedia, Nupedia). Nupedia (which used a 
different, non-wiki technology) didn't catch on, but as soon as the project was 
switched to a wiki, a new culture took hold. Thousands of people starting work- 
ing on Wikipedia and also spreading the word about wikis. 



Wikis go commercial 

The growth of wikis certainly didn't happen in a vacuum. The technology press 
paid attention as did a few academics. As in the open source and engineering 
communities, there was much activity. New wiki engines were created every 
year, and still are. (Dan's current favorite newcomer is TiddlyWiki, a wiki cre- 
ated by using JavaScript, that is contained within an HTML page.) Wikis were 
created for special purposes: DokuWiki is an excellent wiki engine created for 
writing and publishing documentation. Microsoft created a wiki engine called 
FlexWiki as an open source project built by using .NET technology. 
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The commercial use of wikis expanded rapidly through the many, many open 
source wiki engines that were available. Peter Thoeny, creator of TWiki (and 

f of this book), created a huge wiki at Wind River dedicated to product 
Google has revealed that it is a major user of wikis and has one of the 
largest internal wikis in terms of the number of pages. Yahoo!, Amazon, and 
hundreds of other companies have jumped on the wiki bandwagon as well. 



Recognizing that the basic concepts of wikis were quite powerful, and that a 
large segment of the information technology world (the world of corporate 
computer users) was nervous about the support and maintenance burdens of 
open source technology, a number of entrepreneurs stepped in and built on 
the ideas that were developed in the open source wiki engines. Some of these 
include 



f" Socialtext (www.socialtext.com): Ross Mayfield created Socialtext, 
which built a product to deliver the benefits of many of the technologies 
used in social networking as an integrated product. Socialtext combines 
blogs, wikis, and other features to create an environment to help groups 
communicate and do work. 

v* JotSpot (www. jot . com): JotSpot, founded in 2004 by Joe Kraus and 
Graham Spencer, calls itself an application wiki. JotSpot offers a wiki 
with many features, such as e-mail integration and database-like func- 
tionality, which allow it to create wikis that are applications but also 
wikis. JotSpot was purchased by Google in October, 2006. 

v 0 Atlassian (www.atlassian.com): Atlassian, an Australian company, 
created Confluence, what it calls an enterprise wiki that complements 
the company's first product, JIRA (a bug-tracking database). Confluence 
is one of the more popular wikis in corporate environments. 



Hosted u/ikis open the door to ei/eryone 

Other companies such as WikiSpaces, PBwiki, wetpaint, Wikia, BluWiki, 
XWiki, and more offer free wiki hosting, which we discuss in greater detail in 
Chapter 5. These companies frequently put advertising on pages but also 
offer premium versions of wikis with advanced features. Each of these com- 
panies helped promote the use of wikis in environments that were previously 
unfriendly to open source or that wanted the special features in each of these 
products. 

The process of wiki propagation didn't stop inside companies. After wikis 
spread from engineering to other parts of firms, those who dealt with cus- 
tomers realized that wikis could be an excellent way to harvest information 
and build communities. 
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Amazon.com was the most prominent company to put wikis on its site. At the 
end of many Amazon.com pages is a ProductWiki section, where visitors to 
an add their thoughts on the products. Other companies are follow- 
ed the number of wikis facing consumers grows every month. 



Where u/ikis Mill qo 

We have a long way to go before wikis are part of everyday life. Most people 
still don't know the term, let alone the cultural changes that wikis entail and 
the benefits they can bring. We can take a quick look into the wiki future and 
make some predictions, though. 



Wikis become your desktop, your Web site, your intranet 

What has happened for Dan (the other co-author of this book) is that wikis 
have taken the place of his desktop. His day starts at his e-mail inbox and on 
the home page of his wiki. He doesn't store files on his personal computer 
but stores them on the wiki. When he writes a project management note, he 
writes it in the wiki first and then sends a link to the wiki page to others who 
are working on the project, or he copies from the wiki into an e-mail. The first 
step in a new project for Dan? Creating a wiki to manage it. 



Wikis itiiii inOade other applications 

Wikis will come to most people over the next ten years through hosted wikis 
and wikis embedded in other applications. Many wikis that are now being 
developed are being added to existing environments. Large software compa- 
nies have yet to get serious about incorporating wikis into their products, but 
this will all change as Google's incorporation of JotSpot puts wikis into the 
hands of millions of people who cannot get over the current barriers to using 
wikis. Software manufacturers will then take notice, and you will find wiki 
functionality as part of enterprise applications and desktop productivity 
suites. 



Wikis itiiii disappear 

After wikis have conquered, they will disappear and become part of the land- 
scape. Our grandchildren will wonder why anyone ever worked without 
them. Perhaps, they won't be called wikis. They will just be the way things 
are done, just like how WYSIWYG (What You See Is What You Get) editing is 
no longer an innovation for word processors but is instead just the way they 
are assumed to work. 
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In This Chapter 

Introducing the basic skills needed to use wikis 

Navigating wikis 

Editing text on a wiki page 

Creating links to wiki pages 

Attaching files to wiki pages 

Printing wiki pages 

Playing it safe with wiki pages versions 

Using the Changes link to see what's up with a wiki 



f 

■ n the world of wikis, the fundamental act — the source of all value, the 
<£ golden spike, the first cause, the chicken before the egg — is creating a 
page. Your journey to mastery of this skill of terrifying power begins right now. 

If you imagine these words spoken from a mountaintop with lightning flashing 
all around, take comfort in knowing that finding your way around wikis and 
creating wiki pages isn't terrifying at all. After understanding a few simple 
rules and ideas, almost anyone can create a wiki page. And that, my friend, is 
a big reason why wikis have become the sensation they are. 

Millions of wiki pages have been created by average Joes and Josephines all 
over the world. Wikis have been used to create encyclopedias, manage proj- 
ects, document technology, and even write books (like this one, for example). 
The knowledge carried on wiki pages has been used and improved by mil- 
lions of other people. However, the whole ball can't start rolling until some- 
one creates a page on a wiki, and someone else takes a look. 

In this chapter, you explore the knobs, dials, and steering wheels of a wiki. 
You see how to navigate within a wiki; create, link, print, and organize pages; 
and format text. By the end of this chapter, you'll be able to go to a wiki and 
add your own two cents. 
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that you perform requires some basic skills. Dribbling is a basic 
skill that you must learn before playing basketball. You have to know how to 
boil water to cook pasta. Wikis are no different. The basic wiki skills are 

f Navigating wiki pages: Finding your way from here to there and back 
again 

Creating and editing pages: Creating and formatting your own content 
by using wiki markup 

Linking pages: Adding vital links, which is much easier than using HTML 
(Web markup language) 

Mastering these basic wiki skills will take you back to when you started to 
learn how to use a word processor or a spreadsheet. At first, the structure of 
the page seemed strange. Then you started to understand all the moving 
parts and how to make changes. Pretty soon, everything lost its strangeness, 
and a sense of excitement emerged about what you could do with this new- 
found power. Getting started with wikis will remind you of that transforma- 
tion and prepare you to use a tool that can change your life and the way you 
work — forever. 
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The goal of this chapter is to help you master basic wiki skills by using the 
wiki that you can find at http : / / twiki . org. With this wiki (TWiki), you can 
find your way around and then create a page of your own in the sandbox. (A 
sandbox is a practice area where you can do all things wiki with no worries 
because the pages aren't live.) Along the way, we point out those elements 
common to most wiki pages. Hint: You will quickly notice that many ele- 
ments repeat themselves over and over on each page of a wiki. 



However, getting around wikis can be a bit tricky because each wiki is a little 
bit different. Numerous wiki engines exist, each of which has its own style. (A 
wiki engine is the software that drives the wiki, whether TWiki, Confluence, 
or MediaWiki [the wiki engine used by Wikipedia]. See Chapter 10 for details.) 
And, each wiki engine usually allows you to customize the structure of each 
page, moving some elements around. The good news is that wikis aren't that 
different: If you master how to navigate one wiki, you'll know how to navigate 
another, similar to how you browse Web sites with different navigational lay- 
outs without really thinking twice about it. 
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stop is http : / / twiki . org, which is the site for the community 
around TWiki, one of the most popular wiki engines in the world, 
u go to http : / / twiki . org, the first thing that you see is a page 
like the one in Figure 2-1. Open this site in a Web browser if you haven't yet. 




The TWiki.org home page (as shown in Figure 2-1) reflects the general struc- 
ture of a wiki page, which usually has 



A page body that displays the content of the page: For example, every- 
thing under the headline TWiki — An Enterprise Collaboration Platform is 
the page body. 

v* Navigation between webs on the wiki and between parts of the web 
that you might be on: On the left side of the page, under the heading 
Site Map, is a list of links, some of which are webs. 

A web is a group of wiki pages. Read more about them in the upcoming 
section, "Walking through webs." 

A list of tools for editing and doing other things to change the content 
of the page you're viewing: The TWiki.org home page doesn't have the 
list of editing tools because it is an introduction page. This is a theme 
that you might find to be true in many wikis. The first set of navigation 
pages doesn't emphasize editing and content creation. Instead, the first 
set focuses on helping you find your way around the wiki. 



Figure 2-1: 

Start at the 
TWiki.org 
home page. 
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TWiki™ - an Enterprise Collaboration Platform 

What is TWiki? 



Welcome to TWH a flexible powerful ana easy to use 
enterprise collaboration platform and knowledge management 
system It is a Slnxiurett Wiki typically used to run a project 
development space a document management system a 
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To create a page, move from the home page to the page with all the editing 
tools. To do this, first study a bit about how to get around your wiki town, 
known in dull computer science circles as wiki navigation. 



Most wikis have lots of webs, which have pages that link to groups of pages 
and lots of pages that link to each other. Some pages play a navigational role; 
others contain content; and many do both. The beauty of wikis is that the 
way everything is organized is up for grabs and can be crafted to meet the 
needs at hand. For that reason, there is no widely applicable set of rules 
about wiki navigation — just a few simple ones. 



Walking through Webs 

Most wikis are organized into many different webs. All webs — no, we're not 
talking about the World Wide Web here — are simply different groups of wiki 
pages. Webs are the highest level of organization of a wiki. Here's an example: 
If Amazon.com were a wiki, it would have one web for books, another for 
DVDs, another for electronics, and so on. (Although Amazon.com is not a 
wiki, the company is making innovative use of wikis to capture information 
from consumers, as you can find out in Chapter 3.) 

As we mention in Chapter 1, you can think of a wiki as a collection of index 
cards. Imagine two containers in your wiki: one with index cards about U.S. 
presidents and another with index cards about U.S. senators. These would be 
two different webs. Lyndon Johnson would have an index card in each web 
because he was both a Senator and a President. However, even though the 
cards have the same name, they would be different cards. 




Each web has its own set of names for cards. The nerdy name for a set of 
names is a namespace. Most wikis have a way for information on one web to 
link to another, so it is likely that the page in the presidential web would link 
to the senatorial web, and vice versa. 



You can read in Chapter 8 — where we discuss how to design a wiki — how 
to figure out how many webs you need and what should be in them. 




One of the newest ideas in wikis is the sub-wiki, which is a web that is under- 
neath another web. Sub-wikis were created as the number of pages in a web 
grew and grew and became difficult to manage. In essence, sub-wikis allow a 
wiki web to have a directory structure. For example, you could have the 



Wikibook web, the Wikibook/Chapterl web, the Wikibook/Chapter2 web, and 
so on. The chapters in the book are the sub-wikis. 



Finding gour Wag around: Links are on the left, Luke 

At http : / /twiki . org (visit this site if you're not there already), you can 
see that one of the webs listed on the left is named Sandbox web. (Ignore the 
link to download the latest version of TWiki; that's for wiki administrators, 
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not for wiki users.) In a wiki sandbox, you can play around without worrying 
that you are going to break anything. Click the Sandbox web link to go to the 
page shown in Figure 2-2. 



One thing that is almost always true of wikis (and many other Web sites) is 
that the navigation is on the left. The Sandbox web section has links to 
important pages: 

f Sandbox web home: This page goes back to the home page of the web 
(the one shown in Figure 2-2), which can be a handy link to have when 
you want to migrate from deep in a wiki back to the beginning. 

^ Changes: This link shows a list of pages that have recently been 

changed. This can be a great way to find pages you have been working 
on or to see what others have been up to recently. See the upcoming 
section, "Tracking Versions and Changes," in this chapter for details. 

Index: This is just a list of all wiki pages. TWiki calls pages topics. As you 
read more about different wikis, you'll find that one of the problems with 
the fact that a thousand wiki flowers have bloomed is that different wikis 
have different names for the same thing. In other words, although most 
wikis have a topic list on the left, they might use different names, such 
as Index or Contents. 

\>* Search: This link goes to a page that allows searching. 



Figure 2-2: 
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navigation 
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These are the basic navigation tools that allow you to get around within a 
web. Some people call this local navigation, but you don't have to call it any- 
use it to get where you want to go. 



Jumping around in Webs 

In addition to the basic navigation tools listed in the preceding section, wikis 
usually include ways to jump from web to web, or to a specific page. Choose 
from these techniques to jump around in wiki webs: 

t<" From web to web: Underneath the local navigation for the Sandbox page 
shown in Figure 2-2 is a list labeled Webs, which shows the webs on the 
wiki. Because webs represent major content areas, this is the main way to 
get from one big section of a wiki to another. When working with a wiki, 
it's not at all uncommon to have several Web browser windows open, 
each pointing to different webs on a wiki. The list of webs is how you find 
your way around a wiki, just like how you browse through directories 
when you open a file from a word processing or spreadsheet program. 

f* To a page: If you look at the upper-right corner of the page shown in 
Figure 2-2, you can see a Jump field. Enter the name of a page in the 
Jump field and then press Enter to be transported directly to the page 
you're interested in. In TWiki, if you enter the name of a different web, a 
period, and then the name of the page in the different web, you can jump 
right there. For example, type Main.WebPreferences in the Jump box 
and press Enter to go right to the page in the main web. Although not 
every wiki engine has a Jump field, many do. 



Fottouring a trait of bread crumbs 

A bread crumb is a listing of pages — such as TWikiOSandboxOWebHome — 
that you can travel through to get to a page. As you jump around inside wikis 
and wiki webs, remembering where you've been and where you are might 
become difficult. In this situation, bread crumbs come in handy. Because 
most wikis make liberal use of links, you click and click, winding your way 
through all sorts of webs and pages before you land on just the right page. 
When you do land on that page, you want to know where the heck you are. 
Usually, there are many ways to know that, such as looking at the local web 
navigation (in the address bar of your Web browser program), which usually 
says the name of the web. However, that tells you only the web — not how 
deep the page you are on is in the web and how to get there. Bread crumbs 
give you this information. 

At the top of Figure 2-2, the line that reads You are here: TWiki > 
Sandbox Web > WebHome is a bread crumb. In TWiki.org, the first part of 
the bread crumb is the name of the web you're in. The second part is a list of 
pages that you could travel through to get to that page. 
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In TWiki.org, bread crumbs don't tell you how you got to a page, which could 
be_ through many different links. Instead, they tell you how you could get 

the page you are on starting from the main page of the web in which 
)is located. Bread crumbs at TWiki.org and many other wiki engines 
express a hierarchy of pages that are linked to one another. Think of a hierar- 
chy of pages sort of like folders on your hard drive. 



De mroug 



Another sort of bread crumb used on other wikis (like DokuWiki) shows the 
exact set of pages you clicked to get to the page you're on. This sort of bread 
crumb changes each time you take a different route to a page. This type 
of bread crumb tracks where you have been, not which page owns which 
other page. 



Searching a Wiki 

Another popular way to get around a wiki is to search it just as if you were 
in Yahoo! or Google. If you click the Search link in the local navigation of the 
Sandbox web at http : / /twiki . org, you get a page that looks like Figure 2-3. 



Figure 2-3: 

Search 
a wiki like 
any other 
search 
engine. 
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To search the wiki, just type the keywords that you're looking for and then 
press Enter; a list of pages that have those words displays. Try a sample 
http : / /twiki . org. As you can see from the choices under 
h box, TWiki allows the search to be controlled. For example, you 
can search in the text of a page, the title, or both. Most wikis now have 
some way to search through pages. 



Note: Although most wikis have some sort of search capability, they fre- 
quently don't work very well. (Confluence, a commercial wiki engine, is one 
exception to the rule.) For simple searches, they usually work fine. When you 
want to search with multiple keywords or in any fancier way, though, you 
might be disappointed. After a wiki becomes large scale, usually a top-flight 
search engine needs to be added. 



Editing and creating uriki pages 

Knowing how to find pages is useless if there are no pages to find. After you 
get navigation skills under your belt, you can start editing pages. (Editing 
pages is a little easier than creating them, so we start with editing.) One of 
the things that you might have noticed about wiki pages is that they can be 
pretty long. The Sandbox page at http : / / twiki . org is one of the longest. 
This page changes a lot, but the first three links are pretty constant: 

f Sample Applications: These show advanced functions of TWiki.org. 

Generic Sandbox Topics: Some generic pages were created in advance 
for users to play with. 

Create Your Own Sandbox Page: Here, people create their own pages to 
play with. 

The easiest way to start editing a wiki page is to edit one of the Generic 
Sandbox pages at TWiki.org. To do this, click Generic Sandbox Topics, and 
then click any sandbox topic, such as Sandbox45. You will find that almost all 
the pages have something in them. Worry not; these pages were made to be 
edited and re-edited, so just find a page that you want to change and click it. 
You see something like Figure 2-4. 

Look at the top right of the page body area to see four links that provide tools: 

i>* Edit: This link allows the page to be edited in basic text editor format, 
with wiki markup showing, which we cover later in this section. 

f WYSIWYG: This link allows you to edit in WYSIWYG mode. WYSIWYG — 
What You See Is What You Get — means that when you change some- 
thing on a page to make it a heading, you see the text change to become 
that heading. We cover WYSIWYG editing later in this section, too. 
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Attach: This link allows files to be attached to the page. For more about 
this topic, see the later section, "Attaching Documents to Wiki Pages." 

table: This link displays just the page body, without the navigation, 
h is a nice format for printing. More about printing appears later in 
the chapter. (See the upcoming "Printing Wiki Pages" section.) 



All wiki engines have these functions, but the links might be in a slightly dif- 
ferent place. For example, MediaWiki and Confluence use tabs at the top of 
the page instead of links. 

Editing text 

To begin editing, click the Edit link on the sandbox page you selected. 
You will then be asked to enter a login name and password. If you enter 
TWikiGuest (this is case-sensitive, so type it as it's shown here) as the login 
name and guest as the password, you will be allowed to edit the page. After 
you enter the login and password, you see a page like Figure 2-5. 



Figure 2-4: 
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Figure 2-5: 
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Figure 2-5 shows what it's like to edit a page in text mode, which is the most 
common way to edit wiki pages. Text mode is sort of old-fashioned because 
it's not like most modern word processing programs that operate in WYSI- 
WYG mode. See the following section for more on WYSIWYG editing. 

This is called text mode because you enter simple text in a formatting lan- 
guage; what you see when the page is saved and displayed, though, is much 
more attractive. When you click the Edit button, the Web browser that you're 
using asks the wiki engine to reach into the database and grab the text that 
represents the page you were just looking at, putting that text in a form that 
can be edited in the Web browser. 



If you look at the edit page, you see funny things like +++ preceding lines 

of text. You also see spaces followed by * in front of words and sentences. 
You are looking at wiki markup. In wiki text-mode editing, wiki markup con- 
sists of simple patterns of characters that tell the wiki engine to make the 

page look a certain way. For example, using + at the beginning of a line 

tells the wiki engine to make the rest of the text on that line a Level 1 heading, 
which is the largest heading. Using the same text but with two plus signs 
makes the rest of the text a Level 2 heading, which is slightly smaller than 
Level 1. 
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To see how to use wiki markup to edit a wiki in text mode, follow these steps: 

J^ete everything in the text box (the white box in the middle of the 
J^ge) by selecting its contents with the mouse (or by pressing Ctrl+A) 
and then pressing Delete (on your keyboard). 

This wipes out the contents of that window. Now it's a blank slate, just 
waiting for you. (Bask for a moment in the feeling of power this gives you.) 

Type the first line: 

+ My First Wiki Page 

Type the second line: 

++ Level 2 Headings are Smaller than Level 1 Headings 

Type the third line: 

+++ Level 3 Headings are even smaller 

Type the fourth line: 

Type the fifth line: 

Isn't it nice how horizontal rules break up a page 
Type the sixth line: 

* Bullets do as well 

You just typed in wiki markup text that will display in a way that looks 
much better when the edits are saved and the final page is displayed. 

After you enter the text, TWiki allows you to do one of several things. You can 
scroll down to see buttons that allow you to 

Save the page. Clicking the Save button puts the changes you just made 
into the database, and then redisplays the page. 

i>* Preview the page. Clicking the Preview button lets you first see whether 
the page looks the way you like, and then either go back and edit some 
more or save it. 

W Cancel your edit. Clicking the Cancel button discards your changes. 
Your changes are discarded. 




The names of these basic buttons might differ from one wiki engine to 
another, but all wikis offer these basic functions. 



If you save the page you just entered, you see a page like Figure 2-6. 
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Figure 2-6: 
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Remember, if this markup seems strange and difficult, compare it with the 
HTML version shown in Chapter 1, which is even stranger and more difficult. 
Despite its apparent weirdness, using wiki markup in text mode is pretty easy 
to get used to. Millions of people have learned it, and it has the advantage of 
being able to work with the basic capabilities of any Web browser. Editing in 
text mode is one thing that every browser does and does well. 



Using WySlWUG editing 

As we mention earlier, some advanced wikis offer WYSIWYG editors. With 
these, instead of using wiki markup and the text box, you use an editor that's 
almost like the word processors you're likely accustomed to. 

Look in the list of tools in Figure 2-6 to see the WYSIWYG link. If you click that 
link, you see the page shown in Figure 2-7. 

WYSIWYG editing of a TWiki page relies on DHTML (Dynamic HTML) code 
that's sent to the browser to allow editing of pages. You type in your text. To 
format it, you select the text and then click the appropriate toolbar button to 
set the text as a heading, a bullet, or a specific text style. 
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Figure 2-7: 
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When it works correctly, WYSIWYG editing can be quick and easy, and using 
it prevents you from having to learn markup. The great thing about WYSIWYG 
editing tools for wikis is that they open up the ability to create and change 
pages to an even larger group because people who can't or don't want to 
learn wiki markup can still participate. 

A problem with WYSIWYG editing is that it doesn't work consistently — or 
not at all — depending on the browser and the wiki engine you're using. 
Although using the WYSIWYG editor can help you create pages or edit text, 
most frequent users of wikis use wiki markup. As time goes by, fans of wikis 
all hope and expect that this situation will get better and that WYSIWYG edit- 
ing will be the way we all work. But until then, it is always a good idea to use 
the preview feature to make sure your WYS is actually WYG. 

The headings, horizontal rules, and bullets we have shown you are by far the 
most common ways that wiki pages are formatted. There are many more 
tricks to using wiki pages, and we explain them all in Chapter 6. 
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Linking u/iki pages 




rlier discussion of editing pages shows, making things as easy as 
stSre'is a really wiki thing to do. The way that wiki links are created is per- 
haps the most clever innovation of wikis. As you can read in the comparison 
of wiki links and HTML in Chapter 1, you end up typing a lot less to create a 
wiki link than an HTML link. What we don't explain in Chapter 1, though, is 
how exactly a wiki engine knows that the funny-looking text ThisisALink is 
actually a link to a new page. Now, grasshopper, you will discover the ways of 
wiki linking. 



Less is more: Creating a (ink 

The key to understanding wiki links in most wikis is the idea of camel case. 
Camel case describes a string of letters, beginning with an uppercase letter, 
that doesn't contain any blanks, and that has uppercase letters between the 
first and last characters. So to make a word camel case you need a string that 
has at least two uppercase letters separated by at least one lowercase char- 
acters. Camel case words used for wiki links are WikiWbrds. Here are some 
comparative examples: 

**" ThisIsCamelCase 

Thisisnot 
i>* thisisnoT 
thisIsNot 
THisisnot 
V Thisls 
SoisthiS 




One property of camel case linking deserves a special mention: WikiWords 
create links by removing characters from a word instead of adding them. For 
example, the words Wikis For Dummies become a link by taking out the 
spaces: WikisForDummies. For most other forms of linking, such as creating 
HTML links, lots and lots of characters must be added. 

If you haven't done so already, open a wiki page for editing at http : / / 
twiki . org, as described earlier in this chapter. Click the Edit link on a page 
you edited and then add this line to the end of what you already have: 



MyFirstWikiLink 



The page should look similar to Figure 2-8. 
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When you're done typing the link and save the page, the result should resem- 
ble Figure 2-9. 



The novel feature of the page shown in Figure 2-9 is that a question mark — 
which is actually a link — has been added after the word in camel case (the 
WikiWord). The question mark is an indication that the word is a wiki link 
that leads to a page that doesn't yet exist. 




Keep in mind that using camel case is just one strategy for making links easy. 
The original wiki created by Ward Cunningham, TWiki, and many other wikis 
use camel case for links, but we explain other approaches in Chapter 7. In 
fact, for some people, camel case links are confusing, and other methods 



work better. The important thing is that creating wiki links must be easy. 



More is more: Creating a new paqe 

Okay, you can have a link to a page that doesn't exist. So, how does the new 
page get created? Quite simply, actually. All you have to do is click the ques- 
tion mark that appears at the end of the link. (See the previous section on 
creating links.) The browser window takes you to text mode, where you can 
add the content of the page, as shown in Figure 2-10. 
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Indicates this is a link to a page that doesn't exist yet. 



After you add content and then save the page, the link no longer shows up 
with a question mark. Instead, it is a link to the page that you just created and 
shows up underlined in a special color (or however links are identified in 
your browser). 

One implication of using WikiWords for links is that all the pages are going to 
be named as WikiWords as well. In other words, WikiWords are both names of 
links and names of pages. The same WikiWord is used for both the link and 
the name of the page, and the link is created automatically This is a good 
thing because it leaves no room for confusion. This type of simplification is 
just so full of wiki-ness it makes your SpineTingle. 
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Identifying page parents 

Earlier in this chapter, we show how bread crumbs help you identify the posi- 
tion of a page in a wiki's hierarchy. Suppose that on your first wiki page, you 
enter this text: 



+ My First Wiki Page 



After you click Save, you see the page shown in Figure 2-11. One thing to 
notice is that the bread crumbs now reflect that you created the new page as 
a link from your test page. The bread crumbs show the TWiki page, then the 
Sandbox web, then the test page, and finally the new page that you just cre- 
ated. The test page — which in Figure 2-11 is called SandBox45 — is consid- 
ered the parent page of your newly created page. This path from one page 
to another is created when the pages are created. If the link structure is 
changed so that now the Sandbox web also links directly to the page that you 
created, the bread crumbs won't be changed unless you use some of the 
advanced tools that we explain in Chapter 13. 
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Parent pages are also important when creating pages other ways. In TWiki, 
you can add a page by clicking the Create New Topic link on the left side of 
the page and specifying a parent page. In other wikis, you'll see an Add Page 
or Add Child Page link. When you create pages this way, you'll have an option 
to specify what the parent page should be. When you add a link and click it to 
create a new page (as you did earlier), the new page is automatically a child 
of the page on which you added the link. If only managing children were this 
easy in the real world! 



Finding tost pages 

One thing that can happen to a page is that all the links to it can be deleted. If 
this happens, the page can be potentially lost. If the page that links to the page 
is deleted or edited to remove the link, the page is now an orphan or lost. 

However, you can always go to lost pages by using one of two methods: 

*** Use Jump navigation. Type the name of the lost page in the Jump field, 
as we mention earlier in this chapter. 

List all topics in the web. To list all topics in a web, click the Index link 
in the left navigation section. 
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Although it's possible to "lose" a page by erasing the links to it, with wikis, 
you never have to worry about broken links within your wiki. If you rename a 
; (which you can do in TWiki by selecting More Topic Actions, and 
ame/Move Topic), the wiki itself will change the name of the page's 
on every page in the wiki. It's another wiki miracle. 



Attaching Documents to Wiki Pages 

Attaching documents is a feature that emerged as wikis started to be used 
more and more often in the corporate world. In the view of some wiki purists, 
all information on a wiki should be captured on a wiki page. However, this 
isn't practical in a world where so much information is stored in word pro- 
cessing and spreadsheet files. 

TWiki.org solves this problem through the Attach link. When you click the 
Attach link, an Attach page like the one shown in Figure 2-12 is displayed. 
Click Browse to select a file to attach. 



Figure 2-12: 
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The Attach page allows word processing files, spreadsheets, JPEGs, GIFs, 
or PDF files to be attached to a page. When images (JPEG or GIF files) are 
, they appear in the list at the end of the file, but they can also be 
in the body of the page by adding an image link. When the file is 
uploaded, select the Create a Link to the Attached File check box to create 
either a link to the file (if it is not an image) or an HTML image tag that refers 
to the file stored at the end of the page using a special variable. Here's what 
the HTML might look like: 

* Little Pebbles T-Shirt: <br /> 

<img src= " %ATTACHURLPATH% / littlepebblesBW . jpg" 
alt= " littlepebblesBW . jpg " width= " 549 " 
height="779" /> 

The string %attachurlpath% is a TWiki variable that is filled in with the 
directory in which the image file is stored so that it can be displayed on the 
page. You can read much more about variables and how they can be used to 
customize and control links in Chapter 7 and wikis in general in Chapter 13. If 
you attach an image file and choose to have it show up on the page, the 
result looks like Figure 2-13. 



Figure 2-13: 
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This simple file-attaching functionality is quite powerful and enhances your 
ability to create wiki pages that are attractive and serve as a shareable repos- 
documents. Crack! Another bolt of the simplifying lightning of wikis 
k. 



Printing Wiki Pages 

Printing from a wiki is as simple as printing any other Web page in a browser. 
To preview how a printed page will appear, choose FileOPrint in your Web 
browser. If you preview a regular wiki page, you'll probably see navigation 
links and tools that you don't really need on the printed copy. To pretty things 
up, most wikis offer a Printable link on each page. Click the Printable link to 
display a version of the page formatted in an attractive way for printing. 



Tracking Versions and Changes 

One of the challenges of collective ownership of wiki content is that one 
person can change a page in a way that others might not like. On Wikipedia, 
the multilanguage encyclopedia covered in Chapter 4, this happens all the 
time. Pages are changed back and forth in an Internet-era form of a slow- 
motion argument. In the early days of wikis, this was a huge problem because 
there was no record or version of each page. If someone wiped out a page, it 
was gone unless someone had saved a copy. 

In a sizable wiki, having a large number of authors can also create the chal- 
lenge of not knowing what has been updated. Version tracking and the ability 
to see a list of recent changes attack both of these problems head on. 



Hau/ Versions keep Wikis safe 

Versioning is the idea of keeping track of every change made to a page. TWiki 
recognized the versioning problem quite early and was one of the first wikis 
to introduce the idea of capturing every version of a page so that previous 
versions could be referenced and restored, and also so that an audit trail of 
who changed what could be maintained. 



Part I: Introducing Wikis 



p Books 



Look at the bottom of the page shown in Figure 2-14 to see a portion of the 
footer with this text: 

y: r2 < rl 
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The page version numbers start with 1 and increment from there. Each ver- 
sion is referred to by its version number and the letter r. rl is the first ver- 
sion of the page, r2 is the second, and so on. If you click the less-than sign 
between r2 and rl, for example, you see the differences between those two 
pages. If you click rl, you see the earlier version of the page. TWiki also 
maintains versions of attachments to pages. 

With versioning, a lot of the fear of letting multiple authors loose on a set of 
content disappears. 



Tracking changes in a Wiki 

One of the most valuable but least used parts of most wikis — largely because 
most people don't know what it is — is the Changes link. The Changes link 
shows a list of the pages that have been recently changed, when they were 
changed or created, and who changed them. Figure 2-15 shows what TWiki 
presents when the Change link is pressed. 

The Changes report provides a quick summary of what's happening on a web 
as well as allowing you a quick way back to the pages you've been working on. 
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In This Chapter 

Understanding how wikis adapt to a variety of uses 
Surveying wiki categories 
Exploring content- and process-focused wikis 
Getting connected with community-oriented wikis 
Simplifying your life with ease-of-use wikis 
Hunting for more wikis 



7 he universal applicability of wikis represents a challenge to the beginner. 
Wikis can help almost any group of people do almost anything, which 
can make it difficult to figure out how to get started. This chapter takes you 
through all sorts of examples of wikis ranging from the biggest — with hun- 
dreds of thousands of pages, used by thousands of people all over the world — 
to the smallest, which exist to help just a few people. 

In taking this tour, you'll probably find wikis so valuable that they become 
part of your everyday life. You are also likely to find wikis that seem so use- 
less you cannot understand why anyone would ever visit. 

Almost every wiki has ten readers for each person who actively adds content. 
If you really get lucky, you might find a wiki so exciting that you join the core 
content-creating team and start shoveling your ideas and thoughts into it by 
the bucketful. 



The main goal of this chapter is to make the idea of what wikis can do much 
more specific. By the end of this chapter, you will have many ideas for new 
wikis that can help you (or others you know) get where you want to go. 
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iorize wikis in this chapter by the nature of their content or the 
reason why people use them. Sometimes, the content is the star of the show. 
Other times, the group creating the content or the goal of the people who cre- 
ated the wiki takes precedence when categorizing the wiki. Wiki categories 
include 



Content-focused wikis: These wikis focus on a specific kind of content, 
such as reference material, hobbyist content, travel information, or doc- 
umentation on a certain technology. 

V* Process-focused wikis: Some wikis are devoted to the study and 

advancement of processes. A productivity wiki might be used to encour- 
age collaboration and project management within a company. Other 
common types of process-focused wikis include task-oriented wikis, 
advocacy wikis, and educational wikis. 

Community wikis: Most communities can benefit from wikis. Community 
wikis might serve location-specific communities or virtual communities 
built around a shared interest or need. 

Ease-of-use wikis: Wikis are easy to use, so it's only natural that they are 
used to make challenging tasks easier. For example, small businesses fre- 
quently create online brochure Web sites with wikis because they're 
easy to create and manage. Family wikis are used to share news, photos, 
and other information. And personal wikis are used to easily share infor- 
mation about themselves. 

a few things in mind as you read about the wikis in this chapter: 

Not all the wikis mentioned here are public. You won't be able to visit 
the Goowiki that Google uses to help run its company, or the internal 
wikis at SAP, or the Intellipedia used by the United States government. 

The four listed categories are not hard and fast. Some content-focused 
wikis also could be considered process-focused wikis. For example, a 
wiki on Marvel comics could be seen as both an entertainment wiki and 
a productivity wiki. 

V Don't be surprised when you stumble upon unfinished wikis. You 

might come across pages that are half finished or discover that you're 
looking for content that hasn't been created yet. The quality of every 
wiki varies by the intensity of the community's interest in it. 
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When exploring the world of wikis, you'll find that content-focused wikis are by 
far the largest wiki category. Content-focused wikis use the shared-ownership 
and easy editing aspects of wikis to bring together a large group of people to 
create some content. 

In a way, every wiki is about the content on the pages, but sometimes that 
content is just a means to an end. For a book project, a wiki might hold the 
outline and notes. This is not the case in a content-focused wiki. Instead, the 
content on the pages is the end unto itself, and much time is spent creating, 
correcting, massaging, improving, and debating those pages. (Using our book 
analogy, a content-focused wiki would contain a living version of the book 
that could continue to be changed and expanded.) 

Most folks use content-focused wikis, such as Wikipedia, when looking for an 
answer or to learn about a topic. When you encounter pages on a content- 
focused wiki, you might not even know that a wiki is being used to publish 
them. 



boinq research With reference Wikis 

If imitation is the sincerest form of flattery, Wikipedia must feel mightily flat- 
tered. Wikis created to provide reference and encyclopedic information are 
the most active areas of wiki creation, with many of the wikis named wiki-this 
or thal-pedia (in honor, no doubt, of Wikipedia). 

Reference wikis vary in quality, but they can quite frequently be time-saving 
godsends when you're doing something like trying to track down the differ- 
ence between a brouhaha and a donnybrook. If you want to create your own 
reference wiki, visit the following wikis to see how they work. 

Wiktionaru 

http: / /en . wiktionary . org 

Wiktionary — a collaborative online dictionary with more than 300,000 
entries in nearly 400 languages — is to a Webster's dictionary what Wikipedia 
is to Encyclopaedia Brittanica. The English version was launched in 2002 and 
includes definitions, etymologies, pronunciations, sample uses, synonyms, 
antonyms, and translations. The Wiktionary front page features links to a Word 
of the Day, different languages, categories, topics, rhymes, and a thesaurus. 
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'iquote operate under the 
umbrella of the Wikimedia Foundation, which 
runs Wikipedia and many other sites. Most of 
the Wikimedia wikis are reference wikis with a 
well-developed set of pages that explain what 



the wiki is intended to do, how to get involved, 
the proper form for entries, and what is allowed 
and not allowed. Anyone creating their own ref- 
erence wiki would do well to imitate all these 
aspects of the Wikimedia sites. 



Wikiquote 

http : / / en . wikiquote . org 

When you're looking for a famous quote from a movie, book, or historical 
figure, try Wikiquote. Wikiquote is a free, searchable database of quotes from 
people and creative works. The site, launched in July 2003, has blossomed 
quickly Pages are available in nearly 90 languages, and the English version 
of Wikiquote — the largest, followed by German — has nearly 9,000 pages. 
Translations of non-English quotes also are available. Users of Wikiquote can 



search by names, literary works, films, TV shows, themes (such as art or 
love), or categories like Last Words or Tongue Twisters. 



BibleWiki 












http : / /bible . tmtm. com 











BibleWiki has a page for each chapter of the Christian Bible, and the wiki's 
goal is to provide free, scholarly commentary for the entire text, including dif- 
ferent translations and original Hebrew or Greek texts for some verses. The 
site aspires to skirt "disputes over religious doctrine" by sticking to explana- 
tion of the text and avoiding interpretation. 

This site has an elegant design that allows you to locate any verse in the 
Bible with just a few clicks. The community portal offers a list of wanted 
pages, pages that don't exist but are linked to from at least two pages, and 
other suggestions for how to add short articles. You must register to add 
content. 



Baseball Reference Bullpen 

www . baseball -reference . com/bullpen 



Figure 3-1 shows the main page of the Baseball Reference Bullpen wiki. A col- 
laborative encyclopedia of all-things baseball with more than 38,000 articles 
on subjects ranging from statistics, ballparks, Hall of Fame players, the Negro 
League, and even Little League, Baseball Reference Bullpen aims to "collect 
and organize the vastness of baseball knowledge." 
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Fnck Award. 

• The Agullss Clbaenas win 

their lifth Caribbean Series title, 

going 5 - 1 in 2007 Caribbean 

Series play, 
i The 2007 Serie del Carlbe 

begins with the longest game in 

its history - 18 innings. The 

Aguilas of the Dominican 

Republic (LiDOM) defeat the Tigies ol Venezuela 
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Bernle Castro with the winner. 

■ Spring framing for Nippon Professional Baseball 
begins in southern Japan, and Australia. 

■ Reynaldo Gonzalez Lopez (Cuba). Theo Reltsma 
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The Baseball Reference Bullpen goes beyond other reference wikis by provid- 
ing a detailed description of what must be included in an article as well as 
step-by-step instructions for creating and editing pages. 

CosmeticsWiki 

http : / / cosmeticswiki . com 

CosmeticsWiki (as shown in Figure 3-2) has more than 35,000 pages on 
beauty, skin care, hair products, and other cosmetics, including information 
on ingredients, prices, testimonials, and beauty tips. 

CosmeticsWiki was created by Nicki Zevola and Sean Colombo, who saw a 
need that could be filled by a wiki. The site is seeking advertising and has 
referrals to locations where you can buy the products mentioned. The 
CosmeticsWiki revenue model is to earn a percentage on sales of the cosmet- 
ics and skincare items that people buy from links on the pages. Much of the 
site is empty, waiting to be filled. Such wikis with commercial aspirations are 
a relatively new phenomenon, and it remains to be seen whether thriving 
communities will form around them. 
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Brand: Ciifhfue 
Usi Price. $13.50 

Product Information 

No product information listed yet Please add unbiased into Here {opinions and personal experiences go in the User Testimonials 
section below). 

Ingredients 

Ingredients unknown, please add them 

UserTestamonials 

.-'r.-i->'>,V Greal Product! 

This is a must have' II really enhances the color of the eye shadows that I put on top or the touch base It eliminates creasing and 
lading. I use the canvas color and it works well with all mv eve shadows 

ttTCcCti? Can t live without Itl 

I love this product i ahve never had any trouble with it drying out. but I understand that Clinique is reformulating il to address this 
issue. I have used Touch Base for years and never had an ounce of trouble wlfh it. It works great to keep my shadow on throughout 
the day I never need to touch up my eye makeup. This is also waaay easier to apply versus the stick bases that other companies 



Sharpening skills With hobbyist Wikis 

No matter how mainstream or obscure your area of interest or hobby, there's 
likely a wiki to help you learn more or enhance your experiences. The beauty 
of hobbyist wikis is that the truly passionate enthusiasts are the ones creat- 
ing, updating, and adding to the sites, helping ensure that information is up 
to date and thorough. And, the interactivity of wikis means that you can join 
in the online community of like-minded hobbyists if you have something to 
add. The wikis described in the following sections show how wikis can 
enhance a variety of hobby experiences. 

PokerWiki 

http : / /poker . wikia . com 

While away from the table, poker aficionados can read about poker strategy, 
rules, philosophy, tournaments, game selection, bankroll management, and 
casino reviews in nearly 600 articles on PokerWiki. 
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PokerWiki defines a specific purpose for itself that is complementary to other 
well-established sources of information about poker. 

DropBooks 

www . cookbookwiki . com 

Whether you're craving a dish from Bosnia or Brazil, CookbookWiki aims to 
please all palates. The site's mission is to "document every culinary tradition 
of the world." As of early 2007, CookbookWiki contained more than 37,000 
recipes. It also features forums for readers seeking recipes or tips on different 
types of cooking and baking, or ingredients. The wiki — as shown in Figure 
3-3 — aims to act as a central repository for recipes that until now were scat- 
tered over countless countertop cookbooks — some of which might be out of 
print or too splattered with sauce to be useful for future generations. 

CookbookWiki has an engaging and inspiring mission statement that explains 
why the site was created and what it hopes to accomplish. 
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Indian Cuisine - CookbookWiki 
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The Encyclopedia Gamia 

egamia . com 



primarily those permanently attached at the thumb to a video 
console — will find articles on PC games, trading cards, board games, and 
written games at The Encyclopedia Gamia, shown in Figure 3-4. Offshoots 
include pages on TV shows about games and actors who voice video games, 
as well as tech issues related to gaming. 

The Encyclopedia Gamia offers those who create pages a rich selection of 
templates that allow other material on the wiki to be referenced. For exam- 
ple, if you create a page about Donkey Kong, you can include the Donkey 
Kong template that provides links to all other elements related to Donkey 
Kong on the wiki. 



Going, around the World With travel Wikis 

One of the toughest things about travel planning is the difficulty of finding 
centralized, current information. By the nature of the publishing cycle and the 
reality of restaurant turnover, printed guidebooks can soon be out of date. 
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The Encyclopedia Gamia 

A Gaming Wiki 



ww. egamia. com 



Welcome! There are currently 3.493 active articles . with 1390 unique game pages on Encyclopedia Gamia. 

We are looking lor contributions from people like you. to form this into a true source ol Inlormation concerning games of all types - board. 
carO, viOeo. computer, etc For more information on the site, see our AdquI page 



Featured article 
Super Smash Bros. Melee 

Super Smash Bros. Melee is the 

sequel io the Nintendo 64's Super 
Smash Brothers. Players can tight 
with 25 of Nintendo's mascots on over \ 
20 stages This game is known tor its 
ease for new players to pick up and 
play, yet holds enough depth to keep veletan tighter lans 
occupied. Unlike other fighting games. SSBM places emphasis 
on plat forming in combat, and does away with complicated 
bulton combos and the life bar. The game features many 
unlockables. such as characters, stages, and trophies that qive 
trivia and background info on a wide range of Nintendo 
Producls 
Read more. 




Latest site news 

- DONATIONS are now being accepted! If you would like to 

help pay lor I he EG. you can ac so here 
> Tell your friends about the Encyclopedia Gamia! More 

content editors means more comprehensive information. 

Create your FREE account HERE 

• Here is wha! is most searched on Encyclopedia Gamia! 

• We have 1000 Unique game pages 

• Help improve our Stub pages! 

Recent News 

February 22 

OXbax 360 and PS2 gets price cuts in UK 
Price cuts of up to £50 ($98) have been observed 
tor the Xbox 360 Core bundle, dropping the price 
from a suggested retail price of £199.99 (£390) to 
EHfl BB ttgia Wal-Mart nwnert suriermarket chain Asrta 
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Travel wikis — often updated by people who have just returned from a far- 
away locale — are easy to maneuver (even if the streets of your intended des- 
re not), and the information is likely to be current. A travel wiki 
t fit into your back pocket as well as some guide books, but it's an 
avenue worth investigating. 



One good example of a travel wiki is Wikitravel, located at http : / / 
wikitravel . org. Whether you're wondering where you can get the best 
plate of fried bluefish in the Pitcairn Islands (see Figure 3-5) or what kind of 
electrical adapter you'll need in Bahrain, Wikitravel is the place to go online 
before you go in person. The worldwide travel guide has nearly 13,000 desti- 
nation guides and articles on locations near and far. Travelers can pick up 
tips on how to get to destinations, what to see and eat there, and the best 
places to stay — all kept up to date by users of the site. The home page has 
such features as Destination of the Month and Off the Beaten Path as well as 
travel news and fun facts about different destinations. (Did you know? 
"Noodles in Hanoi are often flavored with a few aromatic drops of crushed 
belostomatid, a giant water bug.") 



Figure 3-5: 
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Oceania Polynesia FHcalm Islands 

The Pitcairn Islands : $ are a loosely grouped hartdful ot tiny islands in the remote 
South Pacilic. farther from any continent than any other inhabited island The islands are 
the lasl British colony in tlie South Pacilic. The ruguecl main island was settled by the 
inlamous mutineers of the Bounty and their Polynesian companions, and most ot Pitcaim's 
mere tour dozen current inhabitants are their descendants They are one of the least- 
populated entities given an ISO country code (PNj. 
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Quick Facts 


Capital 


Adams town 


Government 


constitutional democracy 


Currency 


New Zealand dollar (NZD) 


Area 


47 sq km 


Population 


45 {July 2006 est ) 


Language 


English (official). Pitkem 


Religion 


Seventh-Day Adventist 


Electricity 


240V/50Hz 


Calling Code 


B72 
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Travel wikis represent a true hybrid of content- and process-focused wikis. 
Although much of the content is clearly reference material about places, the 
is also about the process of taking a trip. Remember: More often 
a wiki has properties that fit in more than one of the categories we 
discuss here. 



Finding technical documentation Wikis 

One of the most popular applications of wikis in the world of engineering is to 
create a central spot for technical documentation. The ultimate purpose of 
documentation wikis is to provide reference material, but documentation 
wikis also benefit from being easy to use, which allows a large group of 
authors to contribute to and improve the content. 



SAP Enterprise Services Wiki 

https : / /wiki . sdn . sap . com/wiki/x/LQO 

The SAP Enterprise Services wiki documents the Web services that SAP pro- 
vides to allow developers to create new solutions. The wiki (see Figure 3-6) 
contains a general description of why the services were created, how they 
work, and how to use them. Scenarios for applying the services are sug- 
gested, and room exists for those who have used the services to comment on 
tips and tricks. 
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ES Wiki Usage Rules 

Please review the F5- fljjfl P.uk- 1 . before proceeding. Thanks 



The Purpose of the Enterprise Services Wiki 

The Enterprise Services Wiki, a section of the SDN/BPX Wiki, exists to explain what ES bundles are in 
general and to provide details of the services offered for specific ES bundles. The goal of the ES Wiki is to 
engage the community of developers inside SAP and those in the customer and partner organizations who 
are using services in ES bundles and to promote the sharing of information. That is why anyone who has an 
idea can add it to the wiki We encourage you to learn and to share your knowledge The ES bundles wiki is 
the place to do the following things: 

■ Learn about how to put the services in E5 bundles to work building ..: r. -i .. ..n.; i- ...... ii.i ■ ■, 

• Share tips and tricks related to the use of the services. 
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Claroline Development Wiki 

claroline . net/wiki 



line Development wiki is a complete set of technical documentation 
based on the Wikimedia wiki engine that covers everything going on with 
regard to the development of Claroline, which is an open source platform 
for creating e-learning courses. The site is a comprehensive source for all 
aspects of Claroline's development, including plans for new features, discus- 
sions of how the program is being restructured, and links to other forms of 
documentation. 



SugarCRM Support and Development Wikis 

www . sugarcrm . com/wiki 

The wikis of SugarCRM focus on asking and answering questions related to 
the use of SugarCRM. The Sugar Support wiki provides education and refer- 
ence material about SugarCRM. The Sugar Development wiki covers new 
functionality and feature extension for SugarCRM. Both wikis provide detailed 
and complete information. The emphasis of these wikis is the information in 
them, not the formation of a community. The content seems to be in a wiki 
format more for ease of use in creating the content rather than to attract con- 
tributions from outside of Sugar. This is probably because the thriving user 
community at www. sugar forge . org makes other forms of community 
unnecessary. 



Process-Focused Wikis: A Shared 
Space (or a Shared Mission 

Process-focused wikis are all about helping people collaborate and work 
together to get something done. Although process-focused wikis are awash in 
content, the goal of these wikis is not to create that content but to support a 
process: some other activity outside the wiki. 

Wikis for project management are probably the largest category of process- 
focused wikis, but few of them are available on the Internet for inspection. 
After all, you can't have the whole world — or even just your competitors — 
looking at your top-secret projects! The key to getting these wikis going is 
providing a simple way to find the information you need to do your job and 
then to make sure that everyone gets the help they need to start changing 
wiki pages. These wikis thrive after they achieve critical mass and become 
the center of much of the activity in a company. Frequently, they grow organi- 
cally throughout an organization as more and more people find out about 
them and want to use them. 
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The great thing about using a wiki for project management is that almost 
every aspect of a wiki works in your favor. The ease-of-use allows more 
people to start using the wiki right away without any training. The flexibility 
of the page structure is easily adapted to any need. Advanced features for 
structured wikis allow tables of information and simple database-like ele- 
ments to be added to the wiki. After you use a wiki for project management, 
running a large project without one is hard to imagine. 

The wiki used to write this book — hosted at Evolved Media Network — is 
typical of many project management wikis. The wiki has special pages 
devoted to tracking interviews and research documents. Each page has a 
form attached that allows lists of pages to be displayed in a table and sorted 
in various ways. In this way, the pages become sort of like database records. 
Other areas keep track of writer assignments, meeting notes from the project 
managers, schedules, and outlines for each chapter. Each page is easy to 
update and has a different form according to its special need. 



Corporate or productivity wikis are typically password protected and are 
intended for smaller, private groups to collaboratively work on projects, or 
for large corporations to use internally. Large companies such as Google, 
Novell, SAP, Sun, and Motorola all use wikis to help run their internal opera- 
tions, but access to people outside the company is prohibited. 



Getting the job done With 
task-oriented Wikis 

Wikis are increasingly used by corporations, government organizations, and 
professional groups to share information, plan projects, and track develop- 
ments related to their work. In such environments, research wikis are tremen- 
dous resources because accurate, timely information can easily be shared 
and updated by anyone in the organization. 



eBay Wiki 

www . ebaywiki . com 



eBay Wiki (www. ebaywiki . com), as shown in Figure 3-7, draws from the 
expertise of eBay users who contribute articles about buying and selling 
on eBay, eBay policies, seller tools, and more. Much of eBay Wiki is geared to 
more experienced eBay users, and you can also find a New User's Guide for 
surfers unfamiliar with how eBay works. 
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Figure 3-7: 

eBay Wiki 
is a 
clearing- 
house for 
eBay 
knowledge. 
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Intellipedia 

http : / /en . wikipedia . org/wiki / Intel lipedia 

In 2006, John Negroponte, the U.S. intelligence czar, unveiled the govern- 
ment's own "spy wiki," called Intellipedia — a secure, online site available 
only to intelligence analysts and officials with the proper clearance, and used 
to share information among the country's 16 intelligence agencies. According 
to news reports, the site had more than 28,000 pages and 3,600 registered 
users as of late 2006. The creation of Intellipedia came after widespread criti- 
cism following the terrorist attacks of September 11, 2001: namely, that gov- 
ernment agencies were too closely protecting information (instead of sharing 
it with each other) to prevent terrorist attacks and other events. Intellipedia 
operates on the same software that runs Wikipedia, but its contents are not 
available to the public. 

Ganfyd 

www . ganf yd . org 

Ganfyd.org (see Figure 3-8) is the first free, collaborative medical reference 
site and describes itself as an "evolving textbook of medicine." Begun by doc- 
tors and medical students in the United Kingdom, it now has more than 300 
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contributors from the U.K., Ireland, New Zealand, Canada, and Australia — all 
of whom are either medical doctors registered within the country they prac- 
vited guest experts. Only registered users can adapt content, but 
free to read the entries. Subjects include pages on medical and sur- 
gical specialties, primary care, public health, women's health, and a medical 
dictionary, among others. 



Ganfyd.org is a clear example of how wiki culture can be adapted to the 
needs of a particular wiki. Because the quality of the information on 
Ganfyd.org is used in the practice of medicine, only medical doctors or 
experts are allowed to contribute content. The Ganyfyd.org wiki is also a 
hybrid between a reference wiki about medical information and a process 
wiki about diagnosis. 

The name Ganfyd is derived from the usually pejorative slang phrase "Get a 
note from your doctor" — a case in which a patient needs a physicians' note 
to participate in or be excused from an activity, sometimes for legal reasons, 
for school or an employer. 
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TaxAlmanac 

. taxalmanac . org 

torsionals come together on TaxAlmanac, a wiki developed by Intuit, 
which makes tax preparation products. TaxAlmanac — shown in Figure 3-9 — 
allows users to research tax law and peruse around 37,000 articles on the IRS, 
Tax Court decisions, Treasury regulations, and other topics useful in tax 
preparation. 

WikiWikiWeb 

http : / /c2 . com/cgi/wiki 



pBooK 



WikiWikiWeb is the first-ever wiki. WikiWikiWeb focuses on the "people, pro- 
jects, and patterns" — or, the who, what, and how — in software develop- 
ment. Even if the topics and language on WikiWikiWeb seem impenetrable to 
anyone who's not a software engineer or computer programmer, the struc- 
ture of the pages is what's ultimately important to general Web users. The 
idea of modifiable Web pages serves as the foundation upon which all other 
wikis (including Wikipedia) and wiki engines are built. The idea that anyone 
can modify or edit a page on a site to create a breathing, evolving document 
or community is taken directly from WikiWikiWeb. 



Figure 3-9: 

Find tax 
information 
at the 
TaxAlmanac 
wiki. 
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IRS Moves to Prevent Telephone Tax Refund Abuse: Hel p 
Taxpayers Make Accurate Requests 

The Internal Revenue Service announced ioday it is lading additional 
steps !o prevent abuse by tax preparers and help taxpayers make 
accurate requests lor the one-lime telephone excise tax relund. 
This week, IRS Criminal Investigation special agents and IRS 
revenue agents are conducting special site visits with tax preparers 
across the nation to prevent inflated requests made tor the one-time 
telephone tax relund Visits began this week to 22 dilterent tax 
preparers who have handled more than 1,500 tax returns 
"We are taking this unusual step to confront blatant abuse of this 
importan! relund program. ' said IRS Commissioner Mark W. Everson 
"We want tax preparers to prepare accurate tax returns. It Ihey don't. 



10 Million Taxpayers Miss Out on Telephone Tax 
Refunds: IRS Urges People to Check before Filing 

IRS 

Fraudulent Telephone Tax Relunds. Abusive Roth 
IRAs Top Otl 2007 "Dirty Dozen" Tax Scams jE£ 
■ Purchasers ol Honda Hybrids Still Oualify tor Tax 
Credit IRS 
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^jcJABEfl WikiWiki means quick in Hawaiian. WikiWikiWeb — and wikis in general — 
&/^—jf\ were created by Ward Cunningham, a computer programmer who launched 
"\ llff ✓^l^^'iWeb on the site of his software consulting company, Cunningham & 
Jvm^Jj VjfJ^V'S^ 13111 ' mc - ( c2 • com ) in 1995. 

WikimWs 

http : en . wikinews . org 

Wannabe journalists can write to their heart's content at Wikinews, which 
bills itself as "The free news source you can write!" The site strives to main- 
tain a neutral voice and cites all articles. The two most common types of arti- 
cles on Wikinews are synthesis articles, which pull together numerous media 
reports drawn from traditional sources for a fuller view of the news, and orig- 
inal reporting, or firsthand reports from contributors who provide backup 
notes for their articles. 



Making it happen With advocacy Wikis 

There are as many pet issues as there are people — global warming, recy- 
cling, renewable energy, clean water, and the ever-popular world peace. 
Communities are coming together online and using wikis to spread the word 
and sway folks to their side, share information about upcoming events 
related to their issues, update readers on legal or ethical developments, and 
track articles related to the causes. 

Project Backpack 

www . pro j ectbackpack . org 

Project Backpack was an effort to send backpacks and holiday letters to the 
children affected by hurricane Katrina. The simple wiki provided instructions 
about how to help and what to do. In the end, more than 50,000 backpacks 
were sent. 

The About Us page has a message that captures the spirit of most advocacy 
wikis: 

You are Us. Join Us! 

Just get it done. 

Run with it. Take Ownership. 

No formal organization. No org chart. 

No money. No office. No phone. No fax. 

No email address of xxxx@projectbackpack.org 

No one is in charge. Everyone is in charge. 
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b Darwin on EvoWiki, created and edited by readers who want to 
promote evolution education, talk about biology, and offer scientific knowl- 
edge that counters the arguments of creationists. Topics include theories of 
evolution, common descent, creationism, intelligent design, political contro- 
versies, scientists, and lists of other evolutionist blogs. 

SourceWatch 

www . sourcewatch . org 

Run by the Center for Media and Democracy, SourceWatch (see Figure 3-10) 
sees itself as an anti-spin site. Its self-professed goal is to "produce a direc- 
tory of the people, organizations and issues shaping the public agenda," with 
an eye on tracking public relations, propaganda, and the manipulation of 
public perception. It also serves as a directory of think tanks, industry orga- 
nizations, and experts who may speak on behalf of corporations, govern- 
ment, and special interest groups. 



SourceWatch - SourceWatch 



Figure 3-10: 

Untangle 
spin at the 
Source- 
Watch wiki. 
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Welcome to SourceWatch, a collaborative project ot the Center for Media and Democracy i9 to produce a directory of the people, 
organizations and issues shaping the public agenda. A primary purpose of SourceWatch is documenting the PR and propaganda 
activities of public relations firms and public relations professionals engaged in managing and manipulating public perception opinion and 
policy. SourceWatch also includes profiles on rtunk tanks, nidus try -funded organizations and Indus try -friendly expert! that work to 
influence public opinion and public policy on behalf of OOfpMNoW, governments and tpBEH mteiests. Over time SourceWatch has 
broadened to include others involved In public debates including media outlets journalists and government agencies Unlike some other 
wlkis. SourceWatch lias a policy ol itnci Ttrereni nig. and is overseen by a paid edilot. 



majority of 350 people attending a debate on PR 
ethics voted against the team supporting the 
proposition that PR practitioners tiave a 
responsibility to tell the truth Writing in PR Week. 
Daniel Rogers summarized the central premise ot 
the winning team as being "if you are not prepared to 
lie occasionally, you cannot do your job 
successfully." 
• Not-So- 
Liberal 



Popular Articles Over The Last Week 

• After the front pages ot SourceWatch 
Bnd Congresspedia. the third most 
popular article has been that on Neal 
Boortz, the syndicated radio talk show 
host based in Atlanta. Georgia Boortz 
has just released a new book. 
Somebody's Gotra Say It'. In an 
Interview r? about the book on Fox 
News's Hannity S Colmes said: "Look, 
Al Qaeda, they could bring in a nuke 
into this country and kill 100.000 
people with a well-placed nuke 
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CAlSl (Client Access to Integrated Service and Information) 

. ca/wiki 



I wiki is the site of a Canadian nonprofit group that uses open source 
development to create software used for a group of homeless shelters and 
other agencies that help the Toronto homeless population. The software 
allows a greater integration of care and real-time information for employees 
and volunteers at agencies and centers that help the homeless, with a goal of 
reducing chronic homelessness. 

Wikocracy 

http: //wikocracy. com 

On Wikocracy, anyone with a computer can play legislator. Everything from 
the U.S. Constitution to local zoning ordinances — as well as hot-button 
issues like the Patriot Act and the Defense of Marriage Act — are up for edits 
and rowdy, written jousting between collaborators with opposing viewpoints. 
Obviously, none of the revisions are legally binding, but it's nice to take a 
stab at creating your own Utopia online. 



Finding educational Wikis 
for students and teachers 

Teachers and students are turning to wikis to collaborate on classroom pro- 
jects, turn in and grade papers, share curriculum, plan studies, and link to 
information that can be helpful in lessons. These are being used on a small 
scale by single classrooms or on a large scale to disseminate curriculum that 
might not otherwise be broadly (or cheaply) available. In fact, wikispaces.com, 
a hosted wiki that allows you to quickly create a wiki on their servers, is spon- 
soring a program to distribute 100,000 wiki pages at no charge to educators to 
help them broaden and enrich their students' experiences. Some educational 
wikis include 

Curriki (www.curriki .org): Derived from the words curriculum and 
wiki, Curriki (see Figure 3-11) is the wiki of the Global Education and 
Learning Community, a project started by Sun Microsystems to develop 
and freely distribute curriculum materials worldwide. Content is created 
collaboratively by educators and other experts online. The project cur- 
rently focuses on materials for kindergarten through 12th grade and the 
subjects of math, sciences, technology, reading, and languages. 

v 0 Westwood Schools (http://westwood.wikispaces.com): Vicki 
Davis' wiki for Westwood schools covers many topics and classes at the 
school, making excellent use of wikis as both a community building tool 
and as a storehouse of reference information. 



Chapter 3: The Thousand Problem-Solving Faces of Wikis 



pBoqk 



see 


Using Wiki in Education » Blog Archive » CELC becomes Curriki 


o 


■ ' i& ' 


9 http://www.ikiw.Org/2006/12/26/gek:-beco £j » !C|- 




Vii^'^^'" 1 ' rc ci " j 


1 BAF Porta! Greg E Mail DieHaril a WlhiBuildout Avid Spots Quick 


Change ES Workplace 



Figure 3-11: 

Find 
educational 
curriculum 
materials at 
Curriki. 
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Mr. Lindsay's Room 15 Wiki (http: //inrlindsay. pbwiki.com): This is 
a beautiful wiki that shows what a wiki can do for a classroom. Features 
include demos of students' work, book reviews, poems, stories, and tons 
of other resources. It's a wiki run "by the students, for the students." 

CAS 100B Course at Penn State (http://caslOOb.pbwiki.com): The 

CAS100B wiki supports the class covering effective speech at Penn State 
University. The wiki contains a syllabus, assignments, schedules, class 
notes, and different sections for different classes. 



Community Wikis: Exploring 
Common Bonds 

To find out the answer to the eternal question, "How will it play in Peoria?," 
you might want to check out the Peoria wiki. (Yes, there is one.) Community 
wikis can give new and old residents of towns, universities, or big cities all 
the latest information on where to live, places to go, where to eat, things to 
do — and what to avoid. 
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If your community doesn't already have a wiki, you might want to start one 
yourself. Check out these great community wikis for inspiration: 



jWiki (http: //wiki. jhu.edu): This wiki (as shown in Figure 3-12), 
maintained and composed by students and others at Johns Hopkins 
University says its mission is to "increase the quality of student life." To 
that end, JhuWiki contains articles on everything from where to get your 
eyebrows waxed at a salon that feels "rich and snooty" to buying used 
textbooks. On- and off-campus housing guides are included, along with 
lists of sororities and fraternities for those interested in the Greek life. 

ArborWiki (http: //arborwiki.org/city/Main_Page): This wiki (as 
shown in Figure 3-13) is a collection of information about Ann Arbor, 
Ypsilanti, and other places in Washtenaw County, Michigan. ArborWiki 
encompasses information on politics, entertainment, local issues, and 
education. It incorporates a section dedicated to the University of 
Michigan with information for students, faculty, and staff. The site is 
committed to maintaining a free and public wiki for the collection of 
facts, figures, memories, and visions about anything pertaining to the 
area. 



Figure 3-12: 

The JhuWiki 
serves the 
community 
at Johns 
Hopkins 
University. 
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ArborWiki is 
dedicated to 
serving the 
Ann Arbor 
area. 
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Lite in Ann Arbor 

Government and Politics: The Mayor. City Council. 
Washtenaw Counry & Neighborhoods: New West Side. 
Old West Side. Old Fourth Ward, Lower Town 

Relaxing: City Parks, Entertainment. Gardening, 
Recreation, Musk instruction, Indoor Pools 




Things to do: with kids, in the winter, cool projects, 
Or on a [late night 

Issues, the Calthorpe Report, the Greenbeh, Low Income 
Housing, Peiceptions of Ypsilanti 

Nonprofits: ARROW (amateur radio), Assistive Media. 
Food Gatherers. Crowing Hope, imerfanh Council fo> 
Peace and Justice. Jewish Witnesses for Peace and 
Friends, The Neutral Zone (for teens*. Ozone House, 
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This Is ArborWiki. a collection of information about 
Ann Arbor, YpsildrtLi, and other places in Washtenaw 
County that anyone can freely edit (see all articles ). 

Question of the Hour Where can i find Funding to' 
community projects? 

Q Type a title to add a page: 



[What paqes are people asking for:' - more article 
>deas> 



Don't worry about categorization and formatting we 
can handle that for you. 



Shopping and Dining 



Stores: Books, Groceries, Hardware, Pharmaceuticals 
Resale, Services 

Restaurants , Menus" , and Bars . oh my! 




Community wikis don't have to be just for people who live near each other. 
Wikis can also serve people in fan communities, clubs, or other groups with 
shared interests. The following sections describe some nongeographical com- 
munity wikis. 



Goofing off With entertainment Wikis 

Star Wars nuts make up one of the most frequently updated and popular wikis 
on the Web: Wookiepedia. In a world where fan sites exist for nearly every 
show, book, or other pop-culture offering you can think of, and deal in all the 
minutae that true fans seek out, check out these well-designed examples 
before starting your own fan or entertainment wiki: 

Marvel Database Project (www.marveldatabase.com): Launched in 
2005 and edited by both Marvel employees and Marvel Comics fans, the 
Marvel Database Project has expanded from reference materials about 
Marvel Comics like The Official Handbook of the Marvel Universe to 
include original content, profiles on Marvel contracted employees, cover 
art, and other images and comics listings and synopses. 
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v 0 Star Trek wiki (http://memory-alpha.org): This wiki includes the 
most mind-blowing details about Star Trek, including facts, ships, 



pons, timelines, and more. 



kiepedia (http://starwars.wikia.com): Sci-fi fans can get the 
411 on the six popular George Lucas films that make up the Star Wars 
saga on Wookiepedia, a wiki devoted to all aspects of Star Wars. With 
more than 40,000 articles, the encyclopedic English-language version of 
Wookiepedia was the largest Wikia-hosted wiki on the Web, as of late 
2006, according to article count. Many articles on the site read more like 
a fictional history book than a fan site. Contributors describe in great 
depth the battles, governments, creatures, and characters of the Star 
Wars films. The site also includes articles about the real-life culture of 
Star Wars fans and creators. 

t<" Lyric Wiki (www. lyricwiki . org): Useful for brushing up on linguistic 
stylings ahead of a turn at the karaoke mike, or seeking sentiment from 
the lyrics of a favorite love song, LyricWiki has what song lovers are 
looking for. With more than 240,000 content pages, it is among the 
largest MediaWiki on the Web and is searchable by song, artist, album, 
genre, hometown, label, and language. Most notably it has a no-banner, 
no-popup ad policy, a relief to music lovers dogged by such annoyances 
on similar sites. iTunes addicts will find handy quick links to iTunes top 
songs running along the front page. 

Lostpedia (www. lostpedia.com): If the numbers 4-8-15-16-23-42 
keep flashing through your mind, visit Lostpedia to help unravel the 
mysteries — or at least bat around theories — about the engaging but 
often-confusing TV program Lost, which revels in hidden messages and 
cryptic storylines that both intrigue and frustrate loyal fans. The wiki 
also summarizes episodes, delves into character biographies, and posts 
recent news related to Lost and the actors on the show. 

*<" Uncyclopedia (http://uncyclopedia.org): Uncyclopedia is to 
Wikipedia what The Onion is to The New York Times. Uncyclopedia 
describes itself as "an encyclopedia full of misinformation and utter 
lies." You might say that it puts the psych! in en-cyc-lopedia. Heavy on 
sarcasm and inside jokes, the satirical wiki (a parody of Wikipedia) calls 
itself "content-free." However, content does actually exist in the form of 
humorous pieces such as misquotes, made-up news, and "helpful" how- 
to articles such as "How to smell like a fish." 



Hanqinq around at clubhouse tiikis 

One of the most popular uses of wikis is to create a space to keep track of 
happenings in a club. If you go to any of the hosted wiki sites mentioned in 
Chapter 5 and search for the world club, you will find hundreds of listings of 
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wikis dedicated to clubs and other similar organizations. You can find cycling 
clubs, yacht clubs, eating clubs, and on and on. The club sites have informa- 
the clubs, schedules of events, and all the other information you 
pect. 



Getting nerdy tilth technology Wikis 

Given the popularity of wikis with engineers, it's no surprise that technology 
communities are frequently supported by wikis. Almost every significant 
form of technology has a wiki associated with it. Just go to a search engine, 
type in any technology brand or product name, and add wiki as the second 
search term to find at least one wiki (and sometimes many) devoted to the 
topic such as the following examples: 

\>* SuperHappyDevHouse (http://superhappydevhouse.org): 

SuperHappyDevHouse is a wiki dedicated to organizing hackathon events 
in the San Francisco Bay Area in the spirit of the famous Homebrew 
Computer Club that played a key role in the development of the per- 
sonal computer. Hackathons are extended gatherings of people who get 
together to work on their projects and share ideas. The PBwiki-hosted 
wiki gained a huge boost at a SuperHappyDevHouse event. 

V E398 Essentials (http://e398essentials.wikispaces.com): The 

E398 Essentials wiki has a huge trove of information about the Motorola 
E398 cellphone: basic information about the phone along with many tips 
and tricks for hacking it in all sorts of ways. This sort of wiki is typical of 
many technology wikis that have a huge amount of information about a 
very narrow topic. 

V The Greater IBM Connection wiki (http://greaterihm.wikia.com/ 
wiki/Main_Page): The Greater IBM Connection wiki exists to allow 
alumni of IBM (so-called Greater IBM'ers) a place to collaborate on 
issues of common interest. 



Ease-ofMse Wikis: Web Site 
Creation Made East} 

Most of the attention paid to wikis focuses on how the simple mechanisms 
of wikis create new ways of collaboration. But the ease-of-use of wikis all by 
themselves have democratized the web. In about five minutes, anyone can 
now create a Web site. The configuration and customization mechanisms of 
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hosted wikis allow you to make Web sites look almost any way you need or 
want. Ease-of-use wikis aren't focused on how a group works together but 

*w quickly individuals can create wikis to get their content on the Web. 
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Creating small business brochure Wikis 



Whether the local florist, a small chain of dry cleaners, or a restaurant in the 
neighborhood, more and more small businesses are using wikis to create 
their standard brochureware Web sites. EditMe.com, a hosted wiki described 
in Chapter 5, makes changing the layout as easy as possible. Warning: It ain't 
that easy. After you get the hang of it, though, you can really make a site 
shine without having to work with (or pay) specialized programmers, 
www. tortoisetours . com is a fine example of a wiki that just looks like a 
great Web site. 



Making connections With personal 
and family Wikis 

Personal wikis are great places to store information and keep notes, to-do 
lists, appointment books, thoughts, diaries, password lists (in the case of 
password-protected wikis), pictures, blogs, and anything else you might like. 
The beauty of a personal wiki is that all your information is available to you 
anywhere you have an Internet connection. If you leave your appointment 
book at home but you track your schedule on your wiki, you can basically 
"take it with you" as long as you're online. 

Many people keep personal wikis private or share them only with small 
groups via password sign-in, but some examples are public. Here are a few 
to get a feel for what a personal wiki can do: 

http: / /raymondyee . net /wiki /RaymondYee 
I www.memoryarchive.org/en/MemoryArchive 
I*** http : / /guykawasaki .pbwiki . com/Book-Ideas 

Similar to personal wikis are family wikis. These are used to track genealogy, 
post family histories and pictures, provide reunion records, post personal 
blogs, coordinate event calendars, or host online "brag books" of trips, vaca- 
tions, or new relatives. Some good examples of family wikis include 
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http: / /ringf amily . wiki spaces . com 
brooksby . org 



sternf eldt . com 



Hunting (or More Wikis 



Searching for wikis, unfortunately, isn't as easy as your typical Google search. 
Many wikis exist only for small groups of users and are private or password 
protected, meaning that they don't turn up in Web searches. 

However, if you're searching for a wiki on a popular topic that you suspect 
might have a publicly accessible page, the easiest thing to do is to start 
with the granddaddy of all wikis, Wikipedia. Just type a search term in the 
Wikipedia Search box and see what pops up. (See Chapter 4 for more on 
using Wikipedia.) The following Web sites might also be helpful: 



\S http: //en. wikipedia.org/wiki/List_of_wikis: Wikipedia main- 
tains this "wiki of wikis," which also lists the Web's largest wikis. 

http://meta.wikimedia.org/wiki/List_of_largest_wikis: 

This is another list of the largest wikis. 

V 0 http://wikiindex.org: Wikilndex is dedicated to cataloging wikis. 

Alternatively, a Web search on Google, Yahoo!, or any other popular search 
engine can turn up a wiki of interest by typing in your subject matter (for 
example, gardening or classic cars) plus the word wiki. 

Often, smaller wikis or corporate wikis are kept private so that they can be 
edited or read only by small groups of people. If you want to know what kinds 
of companies use wikis in their businesses, some wiki providers offer client 
lists like the one found at http : / /en. wikipedia. org/wiki/Corporate_ 
wiki. 



Finally, hosted wikis (or wiki farms) of the sort described in Chapter 5 some- 
times provide directories of wikis that are publicly available on their site if 
you feel like browsing. Check out lists of hosted wikis like the one at http : / / 
pbwiki . com/public .php. Hosted wikis, such as WikiSpaces .com (www . 
wikispaces . com/site/top), also have lists of the most active wikis on 
their sites. 



Part I: Introducing Wikis 



DropBooks 



Chapter 4 

DropBooks. 7, . 

Using and Improving the 
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Wikipedia 



In This Chapter 

How Wikipedia works 

Adding and editing Wikipedia entries 

What Wikipedia can do for you 

Citing Wikipedia sources in your research 

Deciding whether Wikipedia is reliable 



m M nee upon a time, encyclopedia dealers came to your door to sell you 
\r their multivolume wares so that you and your offspring could truly live 
among the educated. These tomes, which publishers have groomed and 
updated over the course of decades (in some cases, centuries) were long ago 
digitized and put online. Even then, the information maintained the musty, 
authoritative air of a high school reference bookshelf. Just like book sales, 
stock trading, and paper mail, the encyclopedia system appeared to be work- 
ing just fine, thank you. 

Then, in 2001, something Wikipedia this way came. 

The reasons for the success of Wikipedia — now the largest reference Web 
site on the Internet — are a direct result of its wiki-ness. In fact, Wikipedia 
grew directly from an attempt to create a free online encyclopedia (originally 
called Nupedid) that was peer reviewed. Nupedia was a nonstarter until 
one of the founders was introduced to Ward Cunningham's WikiWikiWeb. 
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Then, pow! The idea for a collaborative, informal, rapidly changing reference 
Web site blossomed. 
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iWikipedia is the largest publicly accessible wiki available, it's an 
excellent resource for learning more about wikis in general. This chapter 
shows you how to use Wikipedia as a research tool as well as how to become 
part of the community that supports the project through article editing and 
updating. 

At this point, you might conclude that if any old clunkhead can update 
Wikipedia, it can't be too accurate. To be sure, the accuracy of the information 
on Wikipedia has come under scrutiny. And before this chapter concludes, we 
scrutinize that even more. 



Understanding How Wikipedia Works 

Finding entries on Wikipedia couldn't be easier. To begin exploring Wikipedia, 
visit www. wikipedia . org and then click the link for your preferred lan- 
guage. The home page for your language appears, as shown in Figure 4-1. 
From the home page, you have three ways to drill down to a desired entry: 

f Click one of the subject areas listed in the upper-right corner of the page 
(such as Arts, Biography, or Geography). 

v 0 Click the Categories link just below the subject listings. 

V Enter text into the Search field on the left margin of the page and then 
click the Go or the Search button. 

Wikipedia is so vast that you might never return from this adventure. Along 
the way, though, you might also find an entry that's incomplete, incorrect, 
or in need of some TLC. That means its time for you to go native: Join the 
Wikipedians and become an editor. 

Before you begin editing an entry, understand what separates Wikipedia from 
any other encyclopedia. Table 4-1 compares the Encyclopaedia Britannica 
Online with Wikipedia to highlight the differences. 
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Main Page - Wikipedia, the free encyclopedia 



Figure 4-1: 

The 
Wikipedia 
home page 
gives you 
many 
browsing 
options. 
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Welcome to Wikipedia, 


■ Arts ■ History ■ Society 


the free encyclopedia that anyone can edit. 
l,573,916articlesin English 


* Biography • Mathematics * Technology 
■ Geography • Science • All portals 


Overview ■ Editmo ■ Questions - Helo 


Contents • Categories • Featured content • A-Z index 


Today's featured article 


in the news 



http:/ Zen.wikipedia.org /wiki f Wikipedia About 



An invasion is a military action 
consisting of armed forces of one 

i' ..■■.( ... entity entering 
territory controlled by another 
such entity, generally with the 
objective ol conquering territory 
Of altering the established government. An invasion 
can be the cause of a war. it can be used as a part of 
a laraer strateav to end a war. or it can constitute an 
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■ A United States Air 

Force AC-130 gunship 

attacks suspected 

Ai-Qseda operatives at 

Has Kamboni in 

southern Somalia near 

the Kenyan border. 
• An energy dispute between Russia 




Table 4-1 Encyclopaed 


i< 


i Britannica Online versus Wikipedia 


Encyclopaedia Britannica Online 




Wikipedia 




Founded in Scotland in the 18th ce 


n 


tury. 


Founded in England in the 2 


st century. 


Contributors are experts in their field. 


Contributors are volunteers. 




Includes hyperlinks to other articles 
both within and outside the reference 
material. 


Includes hyperlinks to other articles 
both within and outside the reference 
material. 


Articles are peer reviewed. 




Articles are reviewed by readers but 
not necessarily experts. 


Entries are largely free of bias. 




Entries can be biased, especially when 
first posted. 


Changes are rare. 




Changes are constant. 




Updates annually. 




Updates constantly. 




Removed information vanishes. 




Removed information is always 
available for review. 


Over 12,000 articles. 




Over 1 million articles. 





(continued) 
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Table 4-1 (continued) 


•\ \^iogBiopaedia Britannica Online 


Wikipedia 
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Often includes entries on outlandish 


you would like to learn about. 


or arcane subjects. 


Available in four languages. 


Available in 14 languages (and parts 




have been translated into some 100 




languages). 



Run by Volunteers 

The phenomenal growth of Wikipedia is a direct result of its collaborative 
nature. There are over 1 million registered users of the English version, and 
that doesn't account for the millions of unregistered users. (You don't even 
need to register to edit the pages.) If the entries were subjected to the same 
stringent processes used by formal encyclopedias, it would contain far fewer 
articles. 



Wikipedia itself is the best source of information on just how quickly it is 
growing. Figure 4-2 shows a chart that is part of the entry titled Size of 
Wikipedia. As you can see, Wikipedia started slow but quickly entered a 
growing spurt as more and more volunteers climbed aboard. 
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Wikipedia 
experienced 
sharp 
growth in 
recent 
years. 
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Here is the logic to the rapid growth in the number of articles on the Web 
site. Simply put, more entries lead to more traffic, which leads to more 

ho edit and create pages, which in turn, generates more entries, 
e is potentially never ending. 



Editing Wikipedia entries 

Editing Wikipedia falls into two categories: 



V Creating new entries 

u 0 Updating or changing existing entries 



Most Wikipedia entries can be edited freely by anyone; you don't need an 
account or log-in. However, if you edit an article without logging in, your IP 
address will be logged. If you plan to participate in Wikipedia, we recommend 
that you click the Create Account link in the upper-right corner of most 
Wikipedia pages and create your own account. 




Many of the examples used in this book are based on TWiki and wikispaces.com. 
Wikipedia, however, uses a different wiki engine called MediaWiki. The informa- 
tion in this chapter pertains to MediaWiki only and might not be applicable to 
TWiki, wikispaces.com, or any other wiki you're using. 



The easiest way to start editing Wikipedia is to update an existing entry. First, 
find a suitable page or entry to edit. For this example, we use the 
Wikipedia:Sandbox, which is an area where you can experiment without per- 
manently changing any of the real content. To add new information to the 
Sandbox page, follow these steps: 

1. Type Wikipedia:Sandbox into the Wikipedia Search field and then 
click Go. 

2. Click the Edit This Page tab at the top of the Sandbox page. 

A new page opens with a big, white editing space in the center. This is 
where you type your own text to make changes. 

3. In the editing area, enter the words: This is a test of the Wikipedia 
broadcast system. It is only a test. 

4. Click the Save Page button that's underneath the white box. 

Congratulations! You just edited your first Wikipedia entry! 
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Dressing up your Wikipedia entries 



ing the Wikipedia sandbox (as described in the preceding section), 
'the text you entered looks a little, well, plain. Not to worry! Wikipedia 
lets you dress up the appearance of your text. To change the appearance of 
text, click the Edit This Page tab again and take a look at some of the more 
advanced formatting features of this page. Just atop the white box, where you 
enter text, is a line of square icons, as shown in Figure 4-3. These are your 
basic formatting options. From left to right, they are 

W Bold: Styles the text in boldface 
u 0 Italic: Styles the text in italics 

v 0 Internal Link: Allows you to insert an internal link to another Wikipedia 
article 

External Link: Allows you to insert an external link to a Web address 

t<" Level 2 Headline: Makes the text a level 2 headline, used for major 
headings within an article 

t 0 * Embedded Image: Embeds a picture in the article 

V Media File Link: Creates a link to a media file 

v 0 Mathematical Formula: Formats text as a mathematical formula 

v 0 Ignore Wiki Formatting: Used if your text could be inadvertently parsed 
as Wikipedia formatting code 

u 0 Your Signature (With Timestamp): Adds your signature and editing 
timestamp to the article 

v 0 Horizontal Line: Inserts a horizontal line across the page 

v 0 Redirect: Causes the article to redirect to a different location 

V Strike: Draws a line through the text (strikethrough) 
i 0 * Line Break: Inserts a line break 

V Superscript: Formats the characters as superscript, like a footnote 
number or exponent 

u 0 Subscript: Formats the characters as subscript, like the 2 in H 2 0 

v 01 Small: Makes the characters smaller than the surrounding text 

v 0 Hidden Comment: Inserts a comment that won't be displayed when you 
view the page 

v 0 Picture Gallery: Inserts formatting for two images with captions 

v 0 Block Quote: Inserts formatting for an indented block quote 

v 07 Table: Inserts formatting for a table with two rows and three columns 
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buttons. 
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Editing Wikipedia:Sandbox 

From Wikipedia. the free encyclopedia 



this line alone (sandbox heading)}} 
<< — Hello! Feel free to try your formatting and editing skills h 
automatically be cleaned every 12 hours. — > 

This is a test of the Wikipedia broadcast system. It is only a tei 



li As this page is for editing experiments, this p 



Conlent that violates any copyright will be deleted. Encyclopedic content must be verifiable. You agree lo license your 
confri but ions under the GFDL' 

Edlf summary (BtWfly dnscito* irw changes you have maoo) : 



Adding any of these options to your text is a cinch. For example, to add bold- 
face to one of the words you just added to the page, do the following: 

1. Open the Sandbox page for editing as described earlier in this chapter. 

2. Highlight the word test. 

If the word test isn't on the page anymore, that's okay. Just select any 
word that you want to make bold. 

3. Click the B (for Bold) icon. 

The word test now has three apostrophe marks on either end. This is the 
markup, or code, that tells Wikipedia to turn on boldface. 

To delete the boldface that you just added, simply backspace and erase 
those apostrophe marks from around the word. 



PreVieuJinty and saVinq your changes 

As you edit a sandbox page at Wikipedia (as described in the preceding sec- 
tions), look at the options underneath the big, white edit window. The most 
important element here is the rectangular Edit Summary box. This space is 
used for making a few quick notes about what changes, if any, have been 
made to the page. Underneath that are three buttons: 
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**" Save Page: Click this to save and publish your edits to a Wikipedia page. 
Show Preview: Click this for a sneak peek at the edits you made to a page. 



Changes: Click this to look at every version of the page leading up 
the current version. 

These two links round out the options: 

u* Cancel: Click here to exit the page without saving any of your changes. 

Editing Help: Click here to open a new window showing instructions on 
how to edit the page. 

Finally, you'll see a big box full of characters and symbols with the word Insert 
in the upper-left corner. Should you require a special (perhaps non-English) 
character in your text — such as 0 or Q — you can add it by clicking one of 
the characters in this box. 



Unking pages and Web sites in Wikipedia 

In the course of editing a Wikipedia entry, you will undoubtedly arrive at a 
moment when you want to create a hyperlink or link from a page you're work- 
ing on to another area where the reader can find more or related information 
about that page's content. The types of links that you can create on 
Wikipedia fall into three broad categories: 

i>* Linking to another Wikipedia entry 

Linking to a specific section of another Wikipedia entry 
Linking to an external Web site 

Creating a link to another entry within Wikipedia is the simplest of all three. 
Start by editing a page: 

1. In the white, edit window, type Wiki For Dummies is part of the For 
Dummies series of books. 

2. Add two sets of square brackets around the words For Dummies, like 
this: [ [For Dummies] ] . 

3. Click the Save Page button. 

When you look at the page, the words For Dummies should now appear 
in blue. This signifies a link. Click this link, and you are taken to the 
Wikipedia entry on the For Dummies series of books. 
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This method of linking can be used for any entry. Just determine the name of 
the Wikipedia page, put double square brackets on either end, and Wikipedia 
rest. The title of each entry appears at the very top of its page. 





sometimes find that you want to link to another part of the page you're 
already editing. Wikipedia entries can be long and have many parts. Consider 
the entry on James Bond; it has a section devoted to the original Ian Fleming 
novels, and one about the filmed adaptations. Here's how you would link 
specifically to the section of the entry that is about the films or the books: 

1. In the white edit box, type: James Bond is the star of James Bond Films 
and James Bond Novels. 

2. Add double square brackets around the words James Bond Films and 
James Bond Novels. 

The text should look like this: [[James Bond Films]] and [[James 
Bond Novels] ] . 

Make sure to capitalize Films and Novels. More on that in a bit. 

3. Insert a number sign (#) between James Bond and Films, and another 
number sign between James Bond and Novels. 

The result looks like this: [[James Bond#Films] ] and [[James 
Bond#Novels ] ] . The number sign tells Wikipedia to link to the James 
Bond article, and to the Films and Novels sections, respectively. 

4. Click the Save Page button. 

The links should work. But they don't look too elegant, do they? You can 
fix that. 

5. Edit the page again, scrolling down to find the James Bond links. 

6. Adjust the text to look like this: [ [James Bond#Films | James Bond 
films]] and [[James Bond#Novels | James Bond novels]]. 

You're adding a pipe character (usually found on the key above the 
Enter key on your keyboard). 

7. Save the page. 

The links should be a bit more appealing — not to mention correctly 
capitalized and punctuated! 

Wikipedia links are case sensitive. For example, the link [ [James 
Bond#f ilms ] ] takes you to the James Bond entry but not the Films section. 
In order to go directly to the Films section, you need to enter the link with a 
capital F: [[James Bond#Films ] ] . 
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It's hard to imagine that you would need to link outside Wikipedia for some- 
thing because Wikipedia has entries on most everything. But references, 



iuhj^e one aspect of making good Wikipedia entries, require outside links. 



/cjXj^^t want to link directly to a company's home page or a newspaper 
article, for instance. 

The best way to link to sources outside of Wikipedia is through a named link. 
Creating a named link is quite simple. Here's how it works: 

1. Copy an external Web address and paste it into the white, Wikipedia 
edit box. 

2. Place a single square bracket at the front of the Web address. 

3. At the end of the link, add one space and then type the name of the 
link, followed by another square bracket. 

The link should look something like this: 

[http://www.wiley.com John Wiley & Sons] 

4. Save the page. 



What Wikipedia Cart bo For \lou 



Sure, Wikipedia is handy to have around in case you are the friend who gets 
phoned on Who Wants to Be a Millionaire? And it's certainly a reliable way 
to settle bets of all sorts, but there must be a more serious way to use this 
vast trove of information. The following sections show you how to best use 
Wikipedia as a research tool, evaluate the reliability of Wikipedia entries, 
and contribute to Wikipedia in a valuable way. 



The reasons for choosing Wikipedia as a research tool over more traditional 
forms of reference material might include that 

Wikipedia is extremely up to date. Events that would otherwise take 
months or years to enter the record books can show up as entries on 
Wikipedia in a matter of days. 

Wikipedia contributors come from all across the globe. This means 
that the entries can represent a wide range of opinions and expertise 
from all over the world. 




Using Wikipedia as a research toot 



Wikipedia has an enormous number of visitors. This often leads to 
errors that are caught and corrected quickly. 
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If you do use Wikipedia as a source — and you should probably first check 
whether the person or publisher you're writing for accepts Wikipedia as a 
cite it in a way that acknowledges its unique form. For one thing, 
s that you cite are written collectively so obviously no single 
author can be attributed. The entries are always changing as well, and you 
have no reason to believe that the person who follows up on your citation 
will see the same information you saw unless you supply detailed information 
such as a permanent link to the page along with the exact time, date, and ver- 
sion of the article. 

Open a History tab — found at the top of each Wikipedia entry — to determine 
the time, date, and version of the page you're referencing. 

The exact citation style that you use varies depending on your preferred 
(or required) citation format. Most styles require you to include the date on 
which you accessed the entry along with the direct Web address leading to 
the page. For examples of how to cite Wikipedia in research papers, visit the 
Wikipedia entry titled "Citing Wikipedia." 



Is Wikipedia reliable) 

The creators of Wikipedia are the first to admit that not every entry is accu- 
rate and that it might not be the best source of material for research papers. 
Here are some points to consider: 

is* Look for a slant. Some articles are fair and balanced, but others look 
more like the Leaning Tower of Pisa. If an article has only one source, 
beware. 

f Consider the source. Even if an article cites external sources, check 
out those sources to see whether they are being cited fairly and 
accurately — and do, in fact, reinforce the article's points. 

u>* Look who's talking. If you research the contributors themselves and 
find that they are experts in their fields, you can be more confident in 
the entry. 

Start here, but keep going. Wikipedia should be a starting point for 
research but not your primary source for research material. 

In December 2005, the scientific journal Nature published the results of a 
study comparing the accuracy of Wikipedia and the printed Encyclopaedia 
Britannica. The researchers found that the number of "factual errors, omis- 
sions or misleading statements" in each reference work was not so different — 
Wikipedia contained 162, and Britannica had 123. The makers of Britannica 
have since called on Nature to retract the study, which it claims is "completely 
without merit." 
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visiting controversial entries, look out for edit wars. Edit wars occur 
two contributors (or groups of contributors) repeatedly edit one 
a*is work based on a particular bias. In early 2004, Wikipedia's founders 
an Arbitration Committee to settle such disputes. 

Wikipedia does have some weaknesses that more traditional encyclopedias 
do not. For example 

There is no guarantee that important subjects are included or given the 
treatment that they deserve. 

Entries can be incomplete or in the middle of being updated at any 
given time. 

i>* The writers of entries often fail to cite their original sources, thus 
making it hard to determine the credibility of the material. 

These issues should not deter you from using Wikipedia. Just weigh the limi- 
tations of Wikipedia — and, for that matter, reference works in general. 




Sharing your knowledge on Wikipedia 

Here is a very simple way to make Wikipedia more reliable: by editing, 
improving, or creating an entry based on your own expertise. 

The best way to find entries that are ripe for updating is to look for stubs. 
Stubs are entries in Wikipedia that don't contain enough information to be 
considered complete articles. Wikipedia keeps an ongoing list of the stubs 
most in need of attention; just enter Most Wanted Stubs in the Search field 
to find them. 

Before writing anything on Wikipedia, here are three rules that any contribu- 
tor must abide by: 

Your entry must be original. If you cut and paste text from another 
Web site; or copy directly from a newspaper, magazine, book, song, film, 
television show, or comic; you commit a copyright violation. Any such 
material will be removed from Wikipedia as soon as it is discovered — 
and the history files for the entry will tell Wikipedians exactly who is 
responsible for the copy job. 

Write with a neutral point of view. Wikipedia should not be used as a 
soapbox. The goal is to create a reference work that achieves a common 
good for all people. If you want to spread a message, then think about 
starting your own Editorialpedia. 
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v 0 Use references. As we state earlier, one of Wikipedia's greatest failings is 
that its entries often do not include citations that would help the reader 



e entry find second and third sources to support the article's claims. 




Wikipedia has several sister projects, including Wiktionary, Wikiquote, and 
Wikispecies. They are all run by volunteers like you. If your article idea would 
fit more neatly into one of these projects, consider adding the information 
there instead of just at Wikipedia. 

Wikipedia is founded on collective action. And in that spirit, you should not 
feel the need to act alone when you find a stub worth updating — and you 
don't need to. Wikipedia's Community Portal (just enter Community portal 
into the Search field) is an excellent way to find collaborators and to-do lists 
as well as learn about the latest projects getting underway. 
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In this part . . . 

7 his part takes you from the general idea of wikis 
straight into the details of setting up a wiki, creating 
wiki pages, and making sure that the design looks great. 
Chapter 5 tells you how to find the right hosted wiki for 
your wiki — and also explains just what the heck a hosted 
wiki is. 

After you get your wiki set up, Chapter 6 shows you how 
to make the words on a wiki page dance and sing and look 
just how you want them to. In Chapter 7, you can see how 
to link pages and add links to images and movies and the 
like. Part II comes to a close with Chapter 8, which pro- 
vides advice about how to design your wiki to keep the 
information well organized and easy to find. 
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In This Chapter 

Sampling the hosted wiki tasting menu 
Comparing hosted wiki features 
Choosing the right hosted wiki for you 




For the first seven or so years of the history of wikis (1995-2002), the only 
people who could use wikis were those who could set up their own server, 
install the software, and get a wiki engine running. This barrier to wiki adoption 
goes a long way to explain why during this period, wikis were mostly used in 
engineering departments and other organizations that were highly technical. 
Starting in 2002 and accelerating in 2005, this situation changed to bring wikis 
to the rest of us. Many different groups of people with various motivations got 
together to create hosted wikis — wiki engines that are installed and hosted on 
public servers, removing the administration burden associated with running 
your own. Hosted wikis also provide design templates, so that you can literally 
have a wiki up and running within an hour. Hosted wikis, also known as wiki 
farms, opened the floodgates of wiki usage and are speeding the way forward 
for wikis to become part of the mainstream. Now you can choose from scores 
of hosted wikis. A wiki in every pot! 

No Wiki Academy exists that dictates just how wikis should work or even 
what a Web site must do to be classified as a wiki. Every hosted wiki has a dif- 
ferent idea of what it should be and how it should work. Wikis are like styles 
of cooking, and each hosted wiki is a different meal of many courses. Using a 
wiki is the best way to really understand whether it's right for you, but the 
number of wikis is quite large, and each wiki offers a different set of features. 
Most of us have the time to try a few hosted wikis, but nobody has the time 
to try a few dozen. That's where this chapter comes in: It's a hosted wiki 
menu guide to help you narrow down the list. 
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Choosing a hosted wiki is like looking at a vast list of multicourse meals, each 
with a different set of dishes. When you start out, it's not easy to figure out 
you want two appetizers or one, or whether you should order a 
cheese course. If you ask for spicy, will it be too spicy? To compare 
hosted wikis, we present the equivalent of a tasting menu that introduces 
the different aspects of hosted wikis. The first part of this chapter reviews 
many different hosted wikis and provides advice to help you find the one 
that's right for you. Then we get you started using WikiSpaces, which is one 
of the most popular and simplest hosted wikis. 



^tfkBE^ Because the wiki landscape changes rapidly, the menu we present here is by 
no means complete. WikiMatrix is a Web site (www.wikimatrix. org) with 
an extensive menu of hosted wikis as well as wiki software packages. Another 
of its great features is the WikiMatrix Choice Wizard that can help you find 
the wikis that match your personal needs. (We discuss this wizard further in 
Chapter 10.) 



Choosing the Riqht Hosted Wiki 

Most hosted wikis share many of the same features. In the "Creating a Hosted 
Wiki with WikiSpaces" section, we describe some of that hosted wiki's specific 
features. For now, though, you can get down to the business of figuring out 
which hosted wiki you should use, or at least narrow the list of the hosted 
wikis you want to play with. The criteria to consider when choosing the right 
hosted wiki include 

Ease of setup: Some wikis are just needed for a few weeks to manage a 
ski trip or a quick project. (You can read about a real-life ski trip plan- 
ning example in the upcoming section, "Creating a Hosted Wiki with 
WikiSpaces.") Ease of setup may always be important for you, but it's 
especially important for those ephemeral wikis that you need for only a 
month or two. 

V User invitations and limits: If you anticipate hundreds of users, make 
sure that inviting people is easy and that they can manage their own 
accounts. Also, a large number of the free hosted wikis are free only if 
you have about five users. 

**" Storage space: Some hosted wikis charge if you use more than a fixed 
amount of storage space. 

Open to all comers or just for friends: Some hosted wikis allow private 
wikis only for paying customers. 
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Page protection: Some wikis allow individual pages to be protected, and 
others can protect only all pages in a wiki or none. Protection means that 
authorized users can change the page in question. 



As we allude, many hosted wikis are free — that is, if they have a 
stripped-down set of features. Others carry advertising on your wiki 
pages unless you pay for a subscription. 

V Customization capabilities: Some customizations are free, and others 
cost money. 

Number of wikis: Will there be more wikis like yours, and will they need 
to link to each other? If you need a hosted wiki of your own, you might 
want to use a private label option (see "Adding premium services and 
advertising," later in this chapter) or consider running your own wiki 
engine, as described in Part III. 

v 0 Data export capabilities: If you plan to start with a hosted wiki and 
move it internally later, you need to be able to export the data from the 
hosted wiki. 



Now comes the hard part for us as authors. How can we give useful general 
advice about which hosted wiki will work best for your specific situation? 
Well, the truth is we cannot tell you for sure which wiki is precisely right for 
you. We can offer some help, though. Throughout the rest of this section, we 
list the wiki categories that we outline in Chapter 3 and suggest an appropri- 
ate hosted wiki for each. Keep in mind that some hosted wikis are great for 
creating ease-of-use wikis, and others have features that make them just right 
for content-focused wikis, and so on. 




Using a hosted wiki is the fastest and easiest way to get a wiki up and running. 
These benefits are sometimes not the most important factors, though. Hosted 
wikis might be the wrong choice for wikis used inside a company, especially if 
the wiki contains sensitive information. Or if you plan on building advanced 
structured wikis, hosted wikis probably won't give you the control you need. 
Hosted wikis also might not merge seamlessly into an existing computing envi- 
ronment, such as a corporate portal or directory services. The latter means 
that your users need to remember yet another login and password combina- 
tion. In these situations, you might need to get your own server and install a 
wiki engine on it to meet your needs. Chapters 10 and 11 cover how to do that. 



Exploring hosted u/ikis 

The number of hosted wikis has exploded in the past few years. Every few 
months or so, it seems that several new worthy offerings hit the Internet. 
We can't identify and include a description of every hosted wiki. So instead, 
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we provide the following selection of hosted wikis, chosen based on our wan- 
derings and good taste. If a hosted wiki that you run across isn't on this list, 
d too much into it: It might turn out to be the best hosted wiki out 
ewise, just because a hosted wiki is on this list doesn't mean that 
perfect. We found that each hosted wiki is special in its own way. 



First, we describe the hosted wikis included in this chapter. Then we recom- 
mend wikis for various uses. (If you want to participate in a continuing 
conversation about what's going on with hosted wikis, please visit 
www. evolvedtechnologist . com, where Dan will be monitoring new 
developments and reporting on new hosted wikis as they arrive.) 

BrainKeeper (www.brainkeeper . com): BrainKeeper calls itself an 
enterprise wiki. Its focus is knowledge management and corporate com- 
munication, offering features such as workflow for approvals of content. 
A subscription for nine users is $35 per month or $385 per year, increas- 
ing based on the number of users. This is a wiki for business. 

f Central Desktop (www. centraldesktop . com): Central Desktop's 
motto is "organize, share, collaborate," and this site adds anything and 
everything needed to collaborate in the workplace to the idea of a wiki. 
In fact, the wikiness of Central Desktop is sort of obscured, but many 
people include it in lists of wikis. Features for project management, 
shared calendars, and discussions are all free for up to five users and 
two workspaces. Pricing for up to ten users starts at $25 per month. 

cospire (www. cospire . com): cospire is a site for creating communities 
that uses blogs and wikis along with a system of categorizing and search- 
ing content. You must register to start or join cospire communities, but 
the site is free. The mission of the company that created cospire is "To 
make knowledge sharing practical and addictive." 

i>* EditMe (www. editme . com): EditMe is a wiki focused on making building 
Web sites as easy as possible based on a wiki model. Following the 
desires of its user base, EditMe has advanced features for access con- 
trol, support for blogs, and an easy to use WYSIWYG (What You See Is 
What You Get) editor. EditMe costs $4.95 per month for its most basic 
offering and goes higher from there. 

u* JotSpot (www .jot. com): JotSpot, which calls itself the first application 
wiki company, was purchased by Google in October of 2006. JotSpot 
focused on extending wiki functionality in all directions so you could have 
a shareable, easy-to-edit environment in any application, such as docu- 
ments, spreadsheets, calendars, or photo galleries. JotSpot is currently 
being integrated with Google products, and a launch date of the combined 
offering has not been announced as of the writing of this book. 
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Nexdo (www . nexdo . com): Nexdo is a straightforward, simple wiki offer- 
ing that has a free version for up to five users and a paid version for 
sers that starts at 44 euros per month and increases in price as 
e users are added. 



PBwiki (www.pbwiki . com): PBwiki aims to make creating a wiki as easy 
as making a peanut butter sandwich. PBwiki is one of the simplest and 
easiest to use wikis. It offers a free version and several levels of paid ver- 
sions, starting at $9.95 per month, that include more storage and extra 
features. 

V seedwiki (www. seedwiki . com): seedwiki is a streamlined, bare-bones 
wiki that is perhaps the most similar of all hosted wikis to the original 
wiki created by Ward Cunningham, seedwiki offers a free version as well 
as a paid version that adds features such as access control and notifica- 
tions, starting at $10 per month. 

V Socialtext (www. socialtext . com): Socialtext describes itself as the 
leading enterprise wiki that is most trusted by Global 2000 corporations. 
(Ross Mayfield, Socialtext's CEO and founder, is one of the most cited 
sources on wikis.) Socialtext has advanced features for e-mail integra- 
tion, searching, weblog publishing, and file management. You must call 
SocialText to obtain pricing information. 

f StikiPad (www. stikipad. com): Stikipad is a full-featured wiki solution 
that offers the ability to create and edit wiki pages along with advanced 
abilities for e-mail integration, control over the design of the pages, 
mobile access, spam management, and page locking. StikiPad has a free 
version and also paid versions, starting at $4.95 per month that offer 
advanced administration and technical support. 

f* wetpaint (www . wetpaint . com): wetpaint is a simple and very easy-to- 
use wiki that has one of the best WYSIWYG editors, wetpaint offers the 
ability to comment on each page as well as a wide gallery of styles. 

Wikia (www . wikia . com): Wikia, which was created by Jimmy Wales 
(the founder of Wikipedia), offers hosted wikis that use the MediaWiki 
engine (the engine used at Wikipedia). Wikia is not for personal wikis but 
is intended to host wikis that will attract large communities of editors. 

Wikidot.com (www. wikidot . com): Wikidot offers free hosting for wikis; 
unlike most hosted wikis, Wikidot has no advertising or premium service 
of any kind. 

WikiSpaces (www. wikispaces . com): WikiSpaces is an extremely easy- 
to-use and reliable wiki that is great for beginners; it has a large number 
of educational users. WikiSpaces has premium levels of subscription, 
starting at $5 per month, which offer more storage. 
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Ease-of-use Wikis 



e wikis are those that allow you to do it yourself. Without training 
ise, people can exploit the simplicity of wikis to create Web sites of 
various kinds. The sites that fall into this category simply ignore many of the 
aspects of wikis that have made the idea of wikis so important, such as 
shared authorship and free-form collaboration. 

For example, a woman with a small business could use a wiki to quickly create 
a site to explain her business. The simplicity of wikis would make it easy to 
create the site. She wouldn't have to spend a lot of time working with Web 
designers or programmers. Then, as she gains confidence, she could use more 
and more of the features of the wiki to customize the look and feel of the site. 
Here are some of the features most important to a small business wiki and 
other ease-of-use wikis: 



u* Step-by-step simplicity: You should be helped through each task of the 
wiki with wizards and step-by-step instructions. 

u* Protected pages: You should be able to stop others from editing certain 
pages. A description of a small business is not a collaborative subject. 

Customizable layout, graphics, and fonts: You might not want your 
ease-of-use wiki to look like a wiki at all. You do want it to look sharp 
and polished. 

Of course, the idea of an ease-of-use wiki applies to any simple Web site that 
you want to create. Web sites for individuals, families, and volunteer groups 
are all fine examples of ease-of-use wikis. Creating a simple wiki in one of 
these categories is a perfect way to get started with wikis. 

Any of these hosted wiki are a good choice for ease-of-use wikis: 

EditMe: www . editme . com 
u* WikiSpaces: www. wikispaces . com 

PBwiki: www . pbwiki . com 
v 0 wetpaint: www . wetpaint . com 
V StikiPad: www. stikipad. com 
u* Wikidot.com: www . wikidot . com 



Community Wikis 

Community wikis are centered around some shared interest, whether it's a 
place, a topic, a technology, or a club of some sort. With this sort of wiki, 
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simplicity and ease of use is important. To make many of these wikis thrive, 
though, collaboration is important so that everyone in the community can 

two cents. Communicating through e-mail is important, as are facili- 
viting users, managing accounts, and promoting the wiki. 

Any of these hosted wikis are a good choice for community wikis: 

WikiSpaces: www. wikispaces . com 
PBwiki: www . pbwiki . com 
wetpaint: www . wetpaint . com 
JotSpot: www .jot. com 



Process-focused Wikis 

Process-focused wikis are all about getting work done. Process-focused wikis 
capture all the information about some process and help track its execution. 
Project management wikis are probably the most common form of process- 
focused wiki. Unlike ease-of-use or community wikis, process-focused wikis 
often must manage tabular information and use wiki pages like database 
entries. Spreadsheet-like functions are quite helpful, as is the ability to notify 
people via e-mail when certain pages change. Because process-focused wikis 
are frequently used by corporations or large organizations, the ability to 
tightly integrate with e-mail, word processors, calendars, and other produc- 
tivity tools is crucial. 

Any of these hosted wikis are a good choice for process-focused wikis: 

f*** JotSpot: www .jot. com 

Socialtext: www. socialtext . com 

BrainKeeper: www . brainkeeper . com 

Central Desktop: www. centraldesktop . com 
\^ Nexdo: www . nexdo . com 
\^ seedwiki: www. seedwiki . com 



Content-focused Wikis 

Content-focused wikis are aimed at creating large communities focused around 
creating and maintaining a large body of content. Content-focused wikis need 
to be able to present templates for pages to be created and provide instruc- 
tions to those who would join the community of contributors who create and 
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maintain the content. Content-focused wikis also need to have facilities for 
adding images to pages as well as other features, such as special pages for dis- 
k or facilities for managing changes to pages or rolling back changes if 
: vandalized. 

Any of these hosted wikis are a good choice for content-focused wikis: 



)S Wikia: www . wikia . com 
cospire: www . cospire . com 

i>* WikiSpaces: www. wikispaces . com 
PBwiki: www . pbwiki . com 



Creating a Hosted Wiki rtith WikiSpaces 

WikiSpaces — created by Dominick Bellizzi, James Byers, and Adam Frey in 
2005 — is a great example of a hosted wiki as a user-friendly consumer prod- 
uct. The reason for this lies in the story of its creation: James Byers was plan- 
ning a ski trip with a group of friends. The e-mail thread regarding plans grew 
ridiculously long, and he found existing wiki options lacking — so he created 
his own. The focus on simplicity, ease of use, and premium offerings abound 
in this hosted wiki, all of which might be useful to you while your wiki grows. 

James Byers says that he views managing a wiki like tending a garden — and, 
fittingly, the site's logo is a bonsai tree. "In the garden, the influx of content will 
happen a lot early on — that's the filling in of the flower beds that were left 
early," says Byers. "Then there's weeds that have to be plucked constantly — 
adding a little content here, changing a spelling mistake here. In a healthy wiki, 
that's going to happen constantly. Then later, more weeding, more trimming, 
more pruning." 

WikiSpaces is a safe first choice for anyone getting started using wikis, and 
that's why we focus on it here. To set up a wiki on WikiSpaces, just follow 
these steps: 

1. Gotowww.wikispaces.com. 

The WikiSpaces home page (shown in Figure 5-1) is what you first see. 

2. In the Join Now - Free! area, enter a username, a password, and an 
e-mail address. 

Hold off on entering a space name at this point. You can do that in a 
minute. 

3. Click the Join button. 

You see a screen that looks like Figure 5-2. 
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Figure 5-1: 

WikiSpaces 
makes it 
easy to 
create 
your own 
hosted wiki. 
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Choose the 
type of wiki 
you want to 
create. 
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4. In the Make a New Space Now area, enter a name, decide what kind of 
wiki you want, and then click Create. 



have three choices: 



Public: Absolutely anyone can edit a public wiki. This type of wiki 
is free. 



• Protected: A protected wiki can be viewed by everyone but can 
be edited only by those invited to the space. This type of wiki is 
also free. 

• Private: A private wiki can be viewed and edited only by those 
invited to the space. On WikiSpaces, this kind of wiki is free for 
30 days but then costs $5 per month. 

For the purposes of these steps, we're choosing a protected wiki 
because it fits the greatest variety of uses. After you click Create, your 
wiki comes to life, as shown in Figure 5-3. You now have your own wiki. 



Create a new page by clicking this button. 



Figure 5-3: 

The new 
home page 
of your wiki 

looks like 
this. 



fej wikisfordummies u home Microsoft Internet Exp lorer 



File Edit View Favorites Tools Help 

" Vj ' - ■'* httpi/AvSasfordummies.'Mkispaces.com/ 



wikisfordummies 



Actions 

— 0 New Page 
™ Recent Changes 
Manage Space 

Search 

Navigation 

Wikis For Dummies 
Web 

Wiki Markup Test 



dv/oodsemn Settings Help Sign Out £wiM&pac»ii Ci 
home EdH Tni» P»b° page JJCUSSion ] history rUM 

Wikis for Dummies 

Wikis for Dummies is being written in 2006 by Dan Woods 

The book will cover how wikis work and how you can use wikis to great advantage for many 
different purposes 

Test Link To a f Jev'. Pane 



e)Dane 



jjP Internet 



Chapter 5: Finding a Hosted Home for Your Wiki 



'pBooNS 



5. Click the Edit This Page button and rock on with your bad wiki self. 

Put up a fan site for Eldridge Cleaver or Whittaker Chambers or some- 
g. Use your power wisely. Invite others to work with you. Manage a 
ect. Write a new book on wikis. 



The experience you just went through is pretty much the same for most 
hosted wikis. The differences can start to appear most profoundly when you 
start creating pages and working with others. The rest of this section deals 
with the tasks involved in wiki creation: creating individual pages, editing and 
linking pages, and so on. 



Creating pages 

One of the most useful features of wikis is how they are friendly to unfinished 
or partially completed content. In the first generation of wikis, pages were 
only created by editing a page, inserting links to pages you wanted to create, 
and then saving that page. Then the links to unfinished pages would appear 
in some special way that would allow you to click them and create them. 

Although this form of page creation was popular with engineers who were 
accustomed to writing HTML or other programming languages, it wasn't the 
easiest way for your average bear to create a page. 

Most wikis still support this method, but many others use the page creation 
method that WikiSpaces employs. A New Page button appears at the top left 
of each page (refer to Figure 5-3). When you click the New Page button, a 
form appears, as shown in Figure 5-4. Enter a name and then click Create to 
create the new page. After it's created, you can start entering content. 



Figure 5-4: 

Enter a 
name for 
your new 
page and 
click Create. 
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Editing pages 



od for editing pages differs among hosted wikis. Here are the two 
pages are edited: 



V Through a WYSIWYG editor, which is similar to a word processor: 

Figure 5-5 shows a WYSIWYG (What You See Is What You Get, or visual) 
editor. 

Through wiki markup: Figure 5-6 shows a wiki markup editor. (See 
Chapter 6 for more on wiki markup.) 



Figure 5-5: 

The 

WikiSpaces. 
com 
WYSIWYG 
editor is 
easy to use. 
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If the wiki markup in the text editor looks odd at first, it becomes second 
nature after a while. For more about creating pages and content, check out 
Chapter 6. 
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We all want WYSIWYG editors on wikis to work well. However, the unfortu- 
nate truth is that they are a long way from the quality ease of use, and relia- 
bility of the word processors on our desktops. Most people who add content 
to wikis on a daily basis end up learning enough markup to do what they 
need to do using the wiki markup editor instead of a WYSIWYG editor. 



Linking pages 

Linking pages is the same story To create links, wikis started out with a 
nerdy, efficient, and hard-to-understand technique, but modern hosted wikis 
have come up with a much easier method. 

The easy hosted wiki way to create a link is to use forms and simple drop- 
down menus to help you add a link. When you're in a WYSIWYG editor, click 
the Link button on the toolbar. A form pops up (as shown in Figure 5-7), 
which asks you for all the information needed in the link. 
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Figure 5-7: 

A WYSIWYG 
editor 
makes it 
easy to add 
a link. 
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If you prefer to use the text editor and wiki markup, links are added by using 
markup that looks like this: 

[[Wiki Markup Test Page | Test Link To a New Page]] 

If you save the page on which you entered this text and then click the link, 
you're taken to a page named Wiki Markup Test Page. Note that WikiSpaces 
puts some default information on empty pages that makes it hard to under- 
stand that the page is new. However, if you look at the top of the page, you 
can see that the page is named Wiki Markup Test Page — and if you click the 
Edit button, you will start with a blank page. You can read more details about 
linking pages in Chapter 7. 



Protecting pages and Wikis 

One way to use wikis is to let anyone edit any page. This is how Wikipedia 
works. Many other wikis work this way as well — when the people using and 
editing the wikis are well intentioned and well behaved. Sometimes, though, 
when wikis are public or have controversial content, all kinds of commotion 
breaks loose in the wiki. Spammers have also discovered wikis, sometimes 
entering spam messages in them. In many cases, restricting who may edit 
your wiki makes sense. 

The first wikis had no ability to protect pages. It was considered decidedly 
un-wiki to restrict access. Later, though, many of the early versions of wiki 
engines added features for controlling access to pages in various ways. 
WikiSpaces and a number of other hosted wikis have continued this develop- 
ment trend: One of the most important ways that hosted wikis vary is how 
they restrict access to wiki pages. 
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WikiSpaces has a direct and simple approach to restricting access to editing 
pages. If you are the organizer of a wiki, you have access to the Manage Space 
pice in the column on the left side of the page. (If you don't have 
you are not an organizer and can't change settings that control 
i.) After you click the Manage Space button, you see a page with many 
options. Under Space Settings, click the Members and Permissions link to 
open the page shown in Figure 5-8. 



The Space Permissions grid at the top of the Manage Space page offers three 
choices: 



V Public: This allows pages to be viewed and edited by anyone. 

v 0 Protected: Pages can be viewed by anyone but edited only by space 
members. 

Private: Pages can be viewed and edited only by space members. This is 
a premium option only, available for a monthly fee. 

These three choices meet the needs of most people. You can have a totally 
public wiki, you can restrict editing of pages but still have them be available 
for viewing, or you can keep the whole wiki behind closed doors. 



Figure 5-8: 

Control 
member 
permissions 
here. 
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Other hosted wikis go further than this and allow you to control what can 
happen to individual pages. Some pages can be read only, some can be edited 
;one, and some can be completely private. Some hosted wikis offer 
pikis as the only option for protecting a wiki. If you need to know more 
about protecting your wiki, Chapter 13 goes much more deeply into this topic. 



Inttitrnq others to your tiiki 

After you have enough content in your wiki, get others involved. If you have 
a public wiki, this can be as simple as sending around the Web address of 
the wiki. The WikiSpaces wiki created for this book is located at http : / / 
wikisf ordummies . wikispaces . com. Most hosted wikis create a special 
Web address for your wiki when you create it. 




If you have a wiki that restricts editing to members of the wiki or is completely 
private, people who want to edit pages or see the wiki must create accounts 
(which usually involves creating a username and password and supplying an 
e-mail address) at the hosted wiki where your wiki lives. 



Most hosted wikis make inviting users quite easy. If you look at the bottom of 
the Manage Space page in Figure 5-9, you can see four sections: 

t<" Members: Shows the members of the wiki 

v* Pending Membership Requests: Shows requests that have been sent 
but not yet accepted 

Invite a New Member: Allows you to start the process of inviting a new 
member 

f* Invitation History: Shows all the invitations that have been sent out 

All you have to do to invite a new member is enter an e-mail address or an 
existing WikiSpaces username in the Invite a New Member section and then 
click the Add Member button. You can enter a list of e-mail addresses or user- 
names if you like. When you click Add Member, a prefilled form like the one in 
Figure 5-9 appears. This form allows you to adjust the invitation message 
before sending it. 

Other hosted wikis offer similar mechanisms for inviting users. After users are 
invited, you have to worry about getting people to participate in the wiki — a 
topic that we cover in Chapter 11. 
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Changing the took, feet, 
and design of a Wiki 

Hosted wikis have many different approaches to changing how a wiki looks. 
The sort of things you can change are 





The logo that appears on the wiki 


w 


Header and footer text 




Fonts used on each page 




Menu items 




Colors used on the pages 




The layout of the pages 
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There are usually two broad categories of devices to change the appearance of 
a wiki: ones that are easy to use and those that require much more advanced 
knowledge. WikiSpaces offers both ways to change how your wiki 
change the overall appearance of your wiki, do the following: 



4? 



^!^? 1. Sign in to your WikiSpaces wiki. 



You must be signed in to make changes. 

2. Click the Manage Spaces link for your WikiSpaces wiki. 

3. Under the Space Settings section, click the Look and Feel link. 

4. Click a link to change one of the following aspects of your wiki: 

• Theme: This option is the easiest way to change your wiki. Click 
the Change or Make New Theme link to change the theme of your 
pages. The theme is a collection of settings for how the pages look 
grouped together in a bundle, the colors on the pages, the style 
sheet used on the pages, and the logo on the pages. Free wikis 
have fewer choices for themes. 

• Colors: This option is almost as easy. Enter a six-letter (hexadeci- 
mal) HTML color code to change the background, menu, text, and 
link colors. Or, click Pick Color to open a graphical color chooser. 

• Wiki Stylesheet: Here you can customize the Cascading Style Sheet 
(CSS) used for your wiki. This feature is available only with paid 
WikiSpaces services and requires some CSS knowledge. In other 
words, this is the hard way. 

• Logo: Click Browse to select and upload your own custom logo for 
the wiki. (Another easy and free feature.) 

You can also create templates for pages so that new pages start out looking a 
certain way This can be useful if some pages have information that should be 
on every page or certain sections that should be filled in. Templates are also 
used to control the navigation that appears on the left-hand side of the page 
with links to important pages. Click the Manage Templates link on the 
Manage Space page, and then edit the space .menu template to add links to 
the navigation bar on the left side of all pages in your wiki. 

Templates and style sheets really let you go in many different directions, but 
you have to know what you are doing. We cover this topic in much more 
designing detail in Chapter 8. 
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Adding images, Video, and 

DropBocyKs «"'^ts to a m 

The typical wiki page allows you to have headings; text in bold and italic, and 
underlined; bullet points to various levels; horizontal rules; tables; and links 
to other pages inside or outside the wiki. Most wikis also allow you to upload 
and display images. Web pages these days include 

u 0 YouTube videos 

v 0 Links to RSS (really simple syndication) feeds 
W MP3 files 

u 0 JavaScript programs to get information from other sites 
v 0 Ease-of-use features, such as drop-down menus 

And the list goes on. You also have the option of adding some or many wid- 
gets to your wiki pages that 

v 0 Provide special navigation 

f* Simplify adding content 

**" Notify you via e-mail about changes to pages 

Enable you to add information in tables or forms so that pages can 
become like database records or spreadsheets 

Enhancing pages in this way creates what are known as structured wikis, 
which we describe in detail in Chapter 14. 

It is a challenge for anyone to construct a page with all these elements because 
they all work so differently Hosted wikis have many different approaches. 
WikiSpaces offers wizards that guide you through the most common ways of 
adding special content such as links, images, and tables. An Embed Media link 
helps manage the insertion of the sort of HTML needed to link to video, audio, 
or other elements so they can be accessed from a wiki page. We cover how to 
link to this sort of content in Chapter 7. 



Adding premium services and advertising 

Hosted wikis are businesses. To keep operating, they must collect money to 
pay their expenses and reward their founders. Hosted wikis have two rev- 
enue streams: 
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**" Subscription fees charged for premium services 
Revenue from placing advertising on pages 



ted wikis allow wikis to be hosted without charge if they are public, 
and charge only if the wikis are made private. Some hosted wikis, such as 
WikiSpaces, add advertising to wiki pages. Subscription charges might also 
be required to gain access to premium services. 

The WikiSpaces.com premium offering is pretty typical of hosted wikis. For a 
charge of $5 per month or $50 per year, you get the following: 

Advertising no longer appears on your pages. 
The wiki can be made completely private. 
You can create custom themes. 
You can create custom style sheets. 
i>* You can use encryption when you communicate with your wiki. 



Some hosted wikis charge for how much space your wiki pages use or for 
how much bandwidth is used by people who download pages. 

WikiSpaces also offers another plan to organizations who want to set up their 
own space of multiple wikis. This option — Private Label — allows a whole 
space of wikis to be created, one for each department of a company or one 
for each class in a school, that all live under the same administrative environ- 
ment. For more information about these services, click the Upgrade link at 
the bottom of any WikiSpaces page. 
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In This Chapter 

Putting on wiki makeup with wiki markup 
Reviewing the basics of wiki markup 
Applying HTML to your wiki pages 
Sorting out the different modes for wiki pages 



7 he "secret sauce" of wikis is that they are simple and easy. When it comes 
to making content look pleasing and readable, though, don't get fooled 
into thinking that there is nothing much to wikis. The various ways how you 
can control the appearance of content on wiki pages might not give you the 
unlimited power of a program like Adobe Photoshop, but one look at Wikipedia 
or another advanced wiki shows that the pages can look attractive and nicely 
designed. 

This chapter shows you how to make your wiki pages shine with clarity. The 
early sections build on the quick start provided in Chapter 2, showing you 
the tools that wikis provide for organizing content with headings, bullets, and 
tables. We show you how to add images to pages and also compare how to 
edit pages with wiki markup and WYSIWYG (What You See Is What You Get) 
editors. And don't miss the tricks for using HTML (Hypertext Markup 
Language) tables to give your wiki pages more complicated layouts. 

How most wiki pages are designed and organized falls into one of three pat- 
terns, or modes: 

V Document mode: Pages might look like word processing documents. 

Thread mode: Pages can have comments added one after another in a 
conversational thread. 

Structured mode: Pages might have more advanced structures. 



The characteristics of each of these styles is described and compared in the 
latter part of the chapter. 
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Applying Markup as Content Makeup 

Books* 

is the star of the show on a wiki, formatting content is like applying 
makeup. When formatting content, you attempt to highlight the best features 
of a page so that when someone takes a look at it, he knows at a glance what 
the page is about. Good formatting helps someone scan a page and quickly get 
an idea what it is about, making it easier to dive into the most interesting parts. 

In the examples in this chapter, we use the Sandbox area of TWiki.org, which 
we describe more fully in Chapter 2. If you decide to use any of the other 
hosted wikis mentioned in Chapter 5, you should be able to follow along 
easily. The TWiki.org sandbox is located at 

http : / /twiki . org/ cgi -bin/view/ Sandbox/WebHome 




Scroll down and pick a Sandbox page in which to practice. The first time you 
try to edit a page in the TWiki.org Sandbox web, you are asked for a user 
name and password. Use TWikiGuest as the username and guest as the pass- 
word to be allowed to edit the page. 



Editing Pages vOith Wiki Markup 

Here are the two ways to apply formatting to a wiki page: 

Iv* Use wiki markup. 
Use a WYSIWYG editor (explained later in this chapter). 

Wiki markup is a set of simple character patterns that makes your content 
appear differently. For example, if you put asterisks around a word like this: 

*blockhead* 

That word appears in bold when the page is displayed: 

blockhead 

In many ways, wiki markup is a throwback to the early days of word processing 
programs, which worked the same way. To apply wiki markup to a page, click 
the Edit button on the page. You see the page in a simple text box that shows 
the wiki markup for the page, as shown in Figure 6-1. The page shown in Figure 
6-1 is the same sample page that was created in Chapter 2. If your Sandbox 
page has been changed by someone else, delete the text in the Sandbox page 
and re-enter the text and markup exactly as shown in Figure 6-1. 



After entering the text, scroll down to the bottom of the page and click the 
Save button. You see the page shown in Figure 6-2. 
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Figure 6-2: 
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Rnnkc Wiki markup dialects 

Tro gKraffhwilJ mamip standards exist. Each wiki engine handles markup a bit differently although 
you'll find some common patterns. For example, here are some different ways to indicate a level 1 
(main) heading: 

TWiki.org: Use + at the beginning of a line. 

MediaWiki (used by Wikipedia): Use two equal signs on each side of the text: ==Text for 
Level 1 Heading==. 

is* wikispaces.com: Use one equal sign on each side of the text. 

Each element of wiki markup has its variations. The markup for bullets is usually pretty much the 
samefor mostwiki engines, but markup fortables can be wildly different. Fortunately, wiki markup 
is not a complicated affair. When you start using a wiki, you can easily learn the rules. Most wiki 
engines have links to Help pages. If you click the Show Help link on the Twiki.org Edit page, for 
example, the information in the figure is shown. Wikipedia has a comprehensive cheat sheet for its 
markup at http : / / en . wikipedia . org /wiki /wikipedia : Cheatsheet. 
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The point of wiki markup is to control the way the text appears by following 
some simple rules. The following sections tour the various forms of wiki 
markup. 



Creating hierarchy With headings 

The most commonly used markup is for headings. Headings introduce a wiki 
page and its various subsections, thereby providing structure and hierarchy 
on your pages. The TWiki method for doing this uses three dashes to indicate 
that a line is a heading followed by one, two, three, four, or more plus signs to 
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indicate the level of the heading. One plus sign equals Heading 1, two equal 
Heading 2, and so on, as shown in Figure 6-3. 



Figure 6-3: 

The TWiki 

method to --- +H eading 1 - Heading 1 

- ++Heading 2 — Heading 2 
-+++ Heading 3 - Heading 3 
--Horizontal Rule — 



denote 
headings 
uses a 
series of 
dashes and 
plus signs. 




The exact font and size for headings is controlled by the user's Web browser 
and is usually specified in a style sheet or a skin of the sort that we discuss in 
Chapter 8. 



Inserting buttets 



Bulleted text is probably the second most popular type of wiki markup after 
headings. Bullets are particularly useful in lists because they aid readability. (We 
use bulleted lists throughout this book.) The formula for TWiki bullets is simple: 



* [Three Spaces]* 


= First level bullet 


* [Six Spaces]* = 


Sub-bullet 


* [Nine Spaces]* 


= Sub-sub-bullet 



There is no limit to how many levels of bulleted text you can present. To get 
to a deeper level, just add three more spaces. 



To create numbered bullets, replace the asterisks with numbers, such as 1. 
Any number is okay because the wiki engine will number the bullets properly 
for you. For example, write 

1 bullet 

1 next 

1 one more 

to get 

1. bullet 

2 . next 



3 . one more 



Part II: Making Your Own Wiki 



You need three spaces in front of the number for TWiki; use one for MediaWiki. 




k text goes only to the end of a line of text. This means you cannot 
: under a bullet that contains any carriage returns (what you create 
when you press Enter while entering text). Nevertheless, you can add line 
breaks with the %br% variable: br stands for break. 



Building tables 



Anyone who has used a spreadsheet can attest to the value of tables. Virtually 
all wikis support tables in some form. Although creating a basic table in TWiki is 
a cinch, how tables work in other wikis is one of the biggest areas of variation. 

TWiki creates tables by using vertical bar characters (pipes ). To define a 
table, simply enter text separated by vertical bars like this: 

*Column One Heading* | *Column Two Heading* | *Column Three Heading* 
Row one info for Column 1 | Row one / column 2 | Row one / column 3 
Row two info for Column 1 | Row two / column 2 | Row two / column 3 
Row three info for Column 1 | Row three / column 2 | Row three / column 3 

You get a page like the one shown in Figure 6-4. This is the basic way to 
create a table. TWiki.org table markup is quite powerful. Table 6-1 lists some 
TWiki table formatting markup. 



Figure 6-4: 

Use wiki 
markup to 
easily 
create 
tables. 
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Row one info for Column 1 Row one / column 2 
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Row one / column 3 
Row two / column 3 
Row three / column 3 



Table 6-1 




TWiki.org Table Markup 


Markup 




Description 


| *bold* 


I 


Header cell with text in asterisks 


| center- 


-aligned | 


Cell with at least two spaces on either side (must 
be an equal number) 


right- 


-aligned | 


Cell with more spaces on the left 
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Markup 


Description 




Multiple characters next to each other allow 




the cell to span multiple columns 


N 


Follow-up row of multispan rows 


\ 


At the end of each line, splits rows over 




multiple lines 



The text in table cells can be formatted just like any other text, and image 
links can also be included in tables. (Text formatting is described in the next 
section; image links are described in Chapter 7.) After you get the hang of 
basic table creation, you can start thinking outside the cell, so to speak. 



Formatting text 

Text formatting isn't uniform across wikis although all wikis use formatting 
methods that are simpler than HTML. Table 6-2 lists wiki markup rules for 
popular text styles in TWiki. 



Table 6-2 


Wiki 


Markup for Text Formatting 




To Get This Do 


This 


Examp 


>le Looks Like This 



Bold text Enclose words *Bold* Bold 

in asterisks. 



Italic 


Enclose words 


_Italic_ 


Italic 




in underscores. 






Bold italic text 


Enclose words in 


Bold italic 


Bold italic 




double underscores. 






Fixed font 


Enclose words 


=Fixed font= 


Fixed font 




in equal signs. 







Bold fixed font Enclose words in ==Bold fixed== Bold fixed 
double equal signs. 



Plaintext Enter plain text that <verbatim> Textthatis 

is already formatted Text that is indented or 

with spaces, tabs, Indented or uses tabs 

and line breaks. uses tabs 

</verbatim> 
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romise and tragedy of WYSIWYG 



7ikrlTiami|f cVrtasily be compared with 
HTML or other formatting methods, but it isn't 
easy to compare with a word processing pro- 
gram like Microsoft Word. Early word proces- 
sors used basic markup for text formatting, but 
modern word processors have abandoned 
markup in favor of a one-step process. You 
simply click toolbar buttons to make text bold, 
format headings, or create tables. This sort of 
editing was an innovation in word processing: 
WhatYou See Is What You Get, or l/l/YS/l/l/YGfor 
short. 

Most modern wiki engines have WYSIWYG edi- 
tors. On each page displayed by the TWiki.org 
engine, the WYSIWYG button allows the page 
to be edited by using the Kupu editor, as shown 
in the figure here. 

The Kupu editor works like most word proces- 
sors. You select text and then click a toolbar 
button to form at text. In theory, WYSIWYG is yet 



another wiki feature that removes barriers to 
Web publishing because you don't even have to 
learn wiki markup. 

Applying WYSIWYG editing to wikis has one 
major challenge: the browser. The text edit box 
that is used to edit wiki markup is simple and 
works the same way in almost every browser. 
However, WYSIWYG requires browser plug-ins 
that don't always work reliably. WYSIWYG plug- 
ins are highly sensitive to browser versions; the 
more complex your formatting, the less likely 
that the WYSIWYG editor will work. 

Some WYSIWYG editing plug-ins work better 
than others. JotSpot, the wiki purchased by 
Google, has been one of the leaders in making 
WYSIWYG work. With all its engineering 
resources, perhaps Google will be the first to 
get it right. In the authors' opinion, if you want 
to use wikis, you're better off using wiki markup 
in a text box rather than WYSIWYG. 
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Wiki markup is important, but don't get carried away with it. Keep in mind 
that the key purpose of a wiki is to share content. Focus first on making con- 
^^|^^lable, and improve the appearance of the content later. 



Controlling Layout and 
Formatting With HTML 



HTML is another way to format wiki content and give pages a bit more struc- 
ture than plain wiki markup allows. In some wiki engines, such as TWiki.org, 
you can use HTML; in others, you can't. HTML is harder to read and maintain, 
so use it sparingly. Having said that, if the wiki markup syntax doesn't offer 
the formatting you need and you're familiar with HTML, it's usually an option. 
For example, many forms of wiki markup have no equivalent for strikethrough 
text. In HTML, though, you can enter <strike>deleted text</strike> 
to get dolotod text . 

HTML is also useful for controlling page layout. For example, the home page 
for the wiki web that we used to write this book was designed by Peter 
Thoeny, the creator of TWiki.org, using HTML. Peter created the layout 
shown in Figure 6-5 by combining wiki markup with an HTML table. 



Figure 6-5: 

A wiki page 
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HTML. 
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WnbngProjeets 
Interview Calendar 
Interview Questions 



You are here: TWiki > Wikifordum Web > WebHome 



• 10 !1 feo 2006 00:47 - p*=:erThu-*.. 
Edit WYSIWYG Attach Pnntable 



Workspace for Wiki For Dummies Book 



For Writers 



• WritinoProjects 

• MasterOudtriij 

• Con ten tD^ si an 

• Interview Loo 
■ ResearchLoq 

• WnterGuide 



For Editors 

• ProtgctMan a element 

• MeebnaMinur.es 

• WntinaProiects 

• InterviewCalendar 

• InterviewOuastions 



Content Design & Chapters 



■ Parts/Chapters/Sections 
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The wiki and HTML markup for the page shown in Figure 6-5 looks like this: 



dBooK 



width= " 100% " xtrxtd valign= " top " > 
For Writers 
ritingPro j ects 

* MasterOutline 

* ContentDesign 

* InterviewLog 

* ResearchLog 

* WriterGuide 

++ Content Design & Chapters 

* ContentDesign - Parts/Chapters/Sections 

</td><td valign="top"> </td><td valign="top"> 
++ For Editors 

* Pro j ectManagement 

* MeetingMinutes 

* WritingProjects 

* interviewCalendar 

* InterviewQuestions 

< / tdx / trx / table> 



This use of HTML allows screen space to be used more efficiently. A complete 
explanation of HTML is beyond the scope of this book, but if you already 
know HTML, you can probably use that knowledge as you build your wiki. 

Choosing Wiki Paqe Modes 

One of the magical aspects of wikis is that flexibility never goes away. When 
you put information in a database, you have to spend a lot of time designing 
how the information will be stored; later, changing that structure isn't easy. 
With wikis, though, the information can be captured and structured; how the 
information is organized can be easily changed. Wikis also easily accommo- 
date many different forms of organization for the same information. 

In Chapter 1, we show how wikis can imitate almost any kind of Web site. 
Wikis can emulate bulletin boards, forums, traditional Web pages, and more. 
The three fundamental patterns of wiki pages are 

V Document mode: Pages using this mode are formatted with headings, bul- 
lets, tables, and images, like the pages of a book or a Web site. Ongoing 
collaboration is summarized at the top of the page and (in many cases) is 
summarized by an editor. Document mode pages are usually written in 
third person and unsigned. Although the page is still subject to editing by 
anyone using the wiki, it's an authoritative informational page. 

Thread mode: Thread mode pages are akin to e-mail conversations, sim- 
ilar to what you might see on a Web message board. One person writes 
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some text, the next person responds, another person adds his two cents 



DropBocfe 

tiona 



and so on. The new entries might appear on top of the older ones, or 
might have to scroll all the way to the bottom of the page for the 
t comment. Threaded discussions are usually written in a conversa- 
tional, first-person manner. 



f Structured mode: These pages are like forms with boxes for each field, 
such as name, address, and ZIP code. Structured pages have locked- 
down structures with clear separations for each type of information. 



Within each project, topic, or web, some pages might rely on document mode 
collaboration while others fit better for thread mode discussions. Which mode 
you use is a matter of who will use the page and how. Front pages are, by and 
large, written in document mode for the simple reason that they act as portals 
into the rest of the information in the web or topic. Threaded pages prolifer- 
ate more frequently within webs or topics, though, because of the free form 
and open discussion they facilitate. 

Sometimes combining document mode and thread mode in the same page 
makes sense. For example, you might need a design document (in document 
mode) at the top, followed by a feedback section (in thread mode). The 
MediaWiki engine used by Wikipedia has separate discussion pages (in 
thread mode) for each article page (in document mode). Table 6-3 lists pros 
and cons of each mode. Then throughout the rest of the chapter, we discuss 
each mode in more detail. 



Table 6-3 Document Mode versus Thread Mode 

versus Structured Mode 

Mode Pros Cons 



Document 
mode 


Makes the subject easily 
accessible to newcomers. 
Leverages the knowledge of all 
participants to create an author- 
itative entry on a given subject. 
Combined with links, it 
facilitates the navigation of 
other areas within the wiki. 


Does not promote open 
conversation. 

Requires editors and overseers. 
Can easily become outdated. 


Thread 
mode 


Fast and easy way to share ideas. 
Promotes open dialog 
and collaboration. 
Ensures that you own your 
own words. (No one can modify 
or delete your writing.) 
Supplies a historical record of 
ideas and who contributed them. 


Conversations can become 
messy and hard to follow. 
Newcomers to the project will 
have difficulty getting up to 
speed. 

Can become bogged down 
in arguments rather than 
discussions. 



(continued) 
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Table 6-3 (continued) 



DBoop 

Structu 



mode 



Pros 



Cons 



ured Presents information in a 
highly controlled format. 
Clearly labels different types 
of information. 

Allows structured information 
from databases to be displayed or 
captured by wiki pages. Provides 
a way to automate wiki pages. 



Much more complicated to 
create and maintain than other 
forms of wiki pages. 
Difficult to change. 



Usinq document mode 

Organizing wiki pages in document mode is simple enough: That is, you pre- 
sent content in the format used by most documents. Wikipedia pages explain- 
ing various topics are great examples of document mode. By reading a doc- 
ument mode wiki page, someone who is new to the information can get up to 
speed by simply reading from top to bottom. 

Comparatively, the general structure of document mode pages (except fic- 
tion) is an inverted triangle. Go ahead and draw a triangle in the margin of 
this page with the tip pointing down and the base at the top. This inverted tri- 
angle represents the information on a document mode page. The top of the 
page (the long, flat end of the triangle) contains general information or a 
broad summary of the subject matter. As you work down the page, the writ- 
ing becomes more specific until you reach the last and most detailed data on 
the subject matter at the tip of the triangle. Each level of detail in the triangle 
is identified by the size of the heading. Larger headings identify more general 
information, and smaller headings point to more specific sections. 




Avoid putting too much detail on a single page. Your trip to the tip of the doc- 
ument triangle presents natural places for links to other parts of the wiki that 
offer expanded information. 



A page that uses document mode still has multiple contributors. Comments can 
pile up, especially toward the bottom of the page where the information gets 
more detailed. Document pages periodically need to be edited to remove some 
comments. Refactoring pages is one of the tasks performed by wiki managers, as 
we describe in Chapter 12. Refactoring is acceptable, but here are guidelines to 
follow to respect the original commenter and the participatory nature of wikis: 

**" The text that replaces the comment should accurately reflect the original. 

Always give credit where due. 
i>* Maintain a complete list of contributors. 
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Attaching relevant documents to the bottom of a document mode page (covered 
in Chapter 2) is another excellent way to enhance content. Avoid attaching mate- 
would be a better fit for another page within the same topic. The docu- 
readsheets, and presentations included on a page should offer general 
overviews of the topic, thus serving the goal of the document mode structure. 



Implementing thread mode pages 

It's tempting to think that wiki pages organized in thread mode require zero 
upkeep. Although this is often the case, you have ways to enhance these 
pages as well. Figure 6-6 shows a typical page in thread mode, with one com- 
ment after another. 



Figure 6-6: 

Atypical 
thread 
mode page 
looks 
like this. 



Answer 




A If you answer a question - or have a question you asked answered by someo 
the page and set the status to answered. The status is in a drop-down list below 


ie - please remember to edit 
the edit box. 


I'm getting the same error message on Red Hat Linux ES 4 




edit removed unrelated Perl errors 




- MackHoooer - 25 Jan 2007 





OK managed to fix this on my system The problem stemmed from not following the install directions exactly In particular, 
the Din/LocaiLiDcfg file MUST have been created and edited to reflect the correct path pnor to running bin/configure 

- MackHoooer - 25 Jan 2007 

YES! MackHooper is nght When I removed everything unzipped again and corrected bin/LocaiLib cfg as the first thing 
everything works Tine 

Thanks. MackHooper 

- TonvAlbers - 26 Jan 2007 

See also PerlSEM-orsTemplateProblem . 

- PeterThoenv - 18 Mar 2007 



Add comment 



Change status to AnsweredQuestions ~*} 



In addition to the comments, a thread mode page should include the follow- 
ing types of information: 

A brief summary of the discussion topic at the top of the page 

j> A set of ground rules for the discussion (for example, "No sticks and 
stones, but name calling is okay") 

is' A list of the discussion owners or leaders, along with contact informa- 
tion or links to their personal pages 

In general, the more participants writing entries on a thread mode page the 
better. That said, a thread mode page can grow so large that it becomes difficult 
for even the participants to navigate. One excellent way to avoid the never-ending 
scroll to the bottom of a thread mode page is to offer alternative ways to view 
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the discussion. By using various structured wiki techniques, you can parse 
threaded discussions by author, subject, or date, for example. This requires 
wiki skills but can be well worth the time investment after a thread 
;e grows into a robust, thriving discussion with multiple participants. 



One sign of a successful and constructive threaded discussion is that it even- 
tually yearns to be transformed into a document mode page. Sometimes the 
document mode page replaces the threaded page. 



Using structured mode 

Structured mode pages offer a third way to create wiki pages. Pages orga- 
nized in structured mode follow a predefined template that makes it clear 
how and where comments are to be added. The templates for structured 
mode pages are created by whoever designs the wiki. Chapter 14 explains 
how to create structured wikis and wiki pages. Figure 6-7 shows a structured 
mode page for capturing information about an interview. 



New interview 



Figure 6-7: 

Structured 
mode pages 
often 
include form 
fields. 



Status: 

Interview date: 
Person invited: 
Organization: 
E-mail: 

Phones: 

Job function: 

Web: 

Comment: 



Format: YYYY/MM/DD 



Prefix with V: or C: 



Link to bio etc, format ; [url] [text] ] 



Create New Interview 



Save next page without any changes 



New interviews are based on I'-t^^.'e, , ._cgT-;ni^ ; 3te , :n^r.i-;.vL; : r : and :- t~-. -_ .■. _ ;. ji ^ 3 ^ 
-- NoahRobischon - 01 Dec 200S 



Data fields describe various aspects of the interview, including 

The name of the person being interviewed 
V The date of the interview 

The e-mail address of the person being interviewed 

There are usually rules governing how and when to edit or contribute to a 
structured mode page. Sometimes these rules are self evident (as in the inter- 
view page shown in Figure 6-7). Other times, you might need to spell out the 
rules at the top of the page. 



Chapter 7 

DropBooka . . n . . 

unking, Categorizing, 

and Tagging Wiki Pages 



In This Chapter 

Exploring the wide world of wiki linking 
Creating external links to the outside world 
Adding files, images, and multimedia links 
Grouping pages with category and tag linking 



Even without links, wikis are an easy way to create and share content. 
With links, though, each page has depth because each link is an invita- 
tion to read more, explore, and jump to another topic. Because links are 
easier to create in wikis than in any other sort of Web technology, you have 
no excuse not to use them. The readers of your wiki will thank you for help- 
ing them find the information they need. 

Of course, linking in wikis has its own strange history. As we describe in 
Chapter 2, wikis use camel case links. Camel case was created as a quick and 
easy linking scheme by Ward Cunningham, the inventor of wikis. As the wiki 
concept has grown, other needs arose, and camel case is no longer the only 
way to create a link. For example, tree linking provides more flexibility and 
has become quite popular, especially because Wikipedia adopted it in lieu of 
using camel case. This chapter tells you about both types of linking, includ- 
ing the ways that wiki links go beyond the sort of links you see in plain old 
HTML Web pages. 



Two other kinds of links used in wikis are adding images and linking to 
YouTube videos. Including pages — that is, inserting an entire Web page 
into your wiki page — can be considered a form of linking as well, albeit an 
extreme one. Using categories and tags also creates links to pages, so we 
cover them here, also. 
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Linking Wiki Pages 

3 Books 

with links 



st people think of links in wikis, they usually compare wiki links 
with links on Web pages, but this is a big mistake. Links in wikis are much 
more than just a way to move from one page to the next. The following sec- 
tions show you the true power and capabilities of wiki links. This method and 
other linking methods are explained in this chapter. 

In order for links to work, pages need unique names. Wikis use namespaces to 
ensure unique page names. The web is then the namespace, and each page 
name is a combination of the page name and the web name. You could think 
of the page name as a first name and the web name as a last name. There 
might be a lot of Dans, but only so many Dan Woods (and even fewer Peter 
Thoenys). This also makes it easier to have a common structure in all your 
webs. A wiki might have 50 webs representing 50 different clubs, but each 
club could have its own MeetingMinutes page without fear that the Bridge 
club and the mud wrestling club would get their meeting minutes mixed up. 

Some wiki engines allow one namespace covering the entire wiki engine (this 
would not be the right wiki engine for the 50-club wiki). Other wiki engines, 
such as TWiki.org, use webs as namespaces. 



Linking WikiWords automatically 

In Chapter 2, we explain the basics of automatic linking using camel case 
links. Camel case links are formed by using words with a special character 
pattern that uses capital letters inside the words. The following examples 
show what is and is not camel case: 

ThisIsCamelCase 

Thisisnot 

thisisnoT 

V thisIsNot 
THisisnot 

V Thisls 
W SoisthiS 
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Camel case describes a string of letters that meets three rules: 

string begins with an uppercase letter. 

string doesn't contain any blanks. 

The string has at least two uppercase letters separated by at least one 
lowercase character. 

Camel case words used for wiki links are WikiWords. To create a link in a wiki 
page, simply put in a camel case word and then save the page. If the page 
named by your WikiWord exists, the word shows up as a link to the appropri- 
ate page. If the page doesn't exist, the link shows up in the page but it doesn't 
lead anywhere — yet. When you click the link, you create the page as 
described later in this chapter. (See the section, "Creating pages using links.") 

The good thing about WikiWords is that you can create links lickety-split. 
For example, you're writing furiously when you think of a topic like rhubarb 
pie, which is important to the page that you're writing. All you have to do is 
type RhubarbPie, and there you have it — the link is created. What could 
be easier? 



DropBooKS 




Most wiki engines are trending away from WikiWord linking in favor of free link- 
ing, which we describe later in this chapter. Many engines turn off WikiWord 
linking by default. Check the settings for your engine for whether WikiWord 
linking is enabled for your wiki. 



Preventing false WikiWord (inks 

WikiWord linking does present some problems. First of all, some words don't 
really lend themselves to camel case linking. For example, if you want to link 
to rhubarb instead of rhubarb pie, what do you do? One trick is to write 
RhubarB or RhuBarb, both of which would result in a link. The problem is 
that both of these words look like typing mistakes. 

Another problem is the growing trend of using camel case-style syntax in brand 
names. For example, NetWeaver (the SAP business technology platform) looks 
like a WikiWord, as do some surnames (such as McCullough). Without interven- 
tion, these words would be seen as links in most wiki engines. 

The remedy to false WikiWords used by TWiki.org and some other wikis is to 
have a special character that stops camel case linking from happening. In 
TWiki.org, any of the following methods stop automatic WikiWord linking: 
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<nop>McCul lough 



■-^ I * IMcCullough 

jDOOKS aut ° iink> 

No text here would be automatically linked, not even 

McCullough</noautolink>. 




TWiki.org can also stop automatic WikiWord linking for specific words in 
every wiki by using a plug-in. See Chapter 14 for more on using wiki plug-ins. 



Free linking 



Free linking provides more flexibility than WikiWord linking, but you do have 
to type some extra characters. Suppose you're writing a Wikipedia page, and 
you want to add a link to a page about rhubarb pie. With free linking, you 
would type 

[ [rhubarb pie] ] 



When you save the page, a link is created to the page named Rhubarb pie. (Note 
how MediaWiki capitalizes the first letter when it creates the new page, even 
though the link was lowercase. Maybe the developers decided that otherwise 
the pages would look like they were all written by ee cummings or k.d. lang.) 

When MediaWiki (the wiki engine that runs Wikipedia) encounters words in 
double square brackets, like the ones shown in Figure 7-1, it turns them into 
links when you save the page. The resulting links, shown in Figure 7-2, appear 
without the brackets and in a different color so that users know they can 
click those words and be taken elsewhere. Red means the link doesn't exist; 
blue means it does. 



Figure 7-1: 

Perform free 
linking by 
typing 
double 
square 
brackets 
around 
words. 



Words enclosed within double square brackets become links. 



== Ferscnal history == . 1 . 

Howard G. "Ward" Cunningham received his '"bachelor's decree;;' in interdisciplinary engineering 
("electrical engineering;; and "computer science;;) and his "master's degree;; in computer 
science from [ [Purdue University]]. He is a founder of Cunningham i Cunningham, Inc. He has 
also served as Director of R&D at ; ;Wyatt 5oftware; ; and as Principal Engineer in the 
[ [Tektronix; ] Computer Research Laboratory. He is founder of the ; [Hillside Group; ; and has 
served as program chair of the Pattern Languages of Programs conference which it sponsors. Ward 
was part cf che ; Smalltalk; ; community. From December 2003 until October 2005 he worked far 
[[Microsoft Corporation]] in the "patterns & practices" group. As of October 2005, he is the 
Director of Committer Community Development at the [ [Eclipse Foundation; ] .| 
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B 

page is 
displayed, 
free links 
appear as 
links. 



The brackets are gone, and the words appear in colorto denote this is a link. 



listory 



[edit] 



~1 



loward~U"^vard" Cunningham received his bachelor's degree in interdisciplinary engineering (electrical engineering and computer science) 
and his master s degree in computer science from Purdue University He is a founder of Cunningham & Cunningham. Inc He has also served 
as Director of R&D at Wyatt Software and as Principal Engineer in the Tektronix Computer Research Laboratory He is founder of the Hillside 
Group and has served as program chair of the Pattern Languages of Programs conference which it sponsors Ward was part of the Smalltalk 
community From December 2003 until October 2005 he worked for Microsoft Corporation in the "patterns & practices" group As of October 
2005 he is the Director of Committer Community Development at the Eclipse Foundation 



The MediaWiki engine has some other tricks as well. Table 7-1 lists some of 
the link methods available in MediaWiki and many other engines. 



Table 7-1 



Free Linking 



Link Syntax 



Result 



[ [rhubarb pie] ] 



The link shows up as rhubarb pie onscreen and 
links to the Rhubarb pie page. 



[[rhubarb pie] ] s The link shows up as rhubarb pies onscreen but 

links to the Rhubarb pie page. This is blended linking. 


[ [rhubarb pie 
favorite pie] '. 


my The link shows up i 
onscreen but links 


as my favorite pi 
to the Rhubarb pie page 


e 


For more linking tips and tricks, 


visit 





http : / / en . wikipedia . org/wiki /Wikipedia : How_to_edit_a_page#Links_and_URLs 



Creating pages using links 

Perhaps the most important difference between wiki links and Web links is 
that wiki links can be used to create new pages. When writing a wiki page, a 
common practice is to create links to a topic that you'll come back to later, or 
perhaps to a topic that you think someone else should come back to later. 

When you save a page on which you inserted a link, one of two things happens: 

V The page to which you link already exists, in which case clicking the link 
goes to that page. 

V The page to which you link does not exist. If you click this type of link, a 
new page is automatically created, ready for you to add content. 
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example, 
link — a 1 



Most wikis indicate when a link leads to a page that doesn't yet exist. For 
example, TWiki puts a question mark after the link, as shown in Figure 7-3. On 
es.com and Wikipedia, links to pages that don't exist are shown in 
iu click these indicators — a TWiki question mark, or a Wikipedia red 
a new page is automatically created. 



Figure 7-3: 

Question 
marks 
suggest 
thatthese 
are links to 
pages that 
don't yet 
exist. 



( ClicK 



on B create a new page 



Bob Dylan 

So who is Bob Dylan? 

• Was he ever RobertZim merman 7 ? 

• Does he prefer to hide as Blind Boy Grunt" 1 ? 

And does anyone really care or do we just like lo listen? 

- peboraHOabd^-l - 30 Apr 2007 



ge j 



GMnq life to stubs 

Creating links to pages that don't yet exist has some important implications 
for how you edit and use wikis. Someone creating a link to a page that he 
thinks should exist and then that same person going back to fill it in is a 
pretty straightforward process. It is sort of like saying, "Note to self: 
Remember to add this page later." 

However, when someone creates a link to a page that he thinks someone else 
should fill in, that's a different matter altogether. It is a request to the commu- 
nity: "Hey community! Does someone else know enough to create this page?" 
If you think of such links as requests or votes, you have a way to see what 
types of pages the wiki community wants to see created. Chances are that the 
pages with the most requests or votes are the ones that the community 
wants most. 



Many wikis keep lists of pages that don't exist or have just a small amount of 
information in them. These pages are stubs or short pages. Figure 7-4 shows the 
stubs page for BibleWiki. If you're looking for a good way to contribute to your 
favorite wiki, peruse that wiki's stubs page to see what needs to be done. 
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Figure 7-4: 

This page at 
BibleWiki 
lists page 
stubs. 



f Category: Stubs Bible Wiki Windows fnisrwi Exflloiet 
^ » ,£ hm//kble.tmtm.com/vjiki/Category:Stubs 



jfegory Stubs - BibleWiki 




navigation 

• Mam Page 

• Communitv portal 
« Recent changes 

■ Random page 

■ Help 

■ Donations 



search 



[J5J I S63CCI1 | 



What linl:s here 
Relatea changes 
Upload file 
Special pages 
PrlnlaDle version 
Permanent linK 



category discussion ' 

Category:Stubs 



Articles vvhich need some meat 



Articles in category "Stubs" 



There are 52 articles in this category 
A 

- Abela 

• Abeldomum Maacha 

■ Abel maim 

■ Abran 

■ Abydenus 

• Act am 

■ Achsaph 

■ Acrabatane 

- Acratwm 

■ Ac ran 

■ Adada 

■ Adadremmon 

■ Adams 

■ Ad ami 

■ AdiarJa 

■ Adithaim 

- Adorn 



Adcmmim 

Adon 

Aduram 

Agars Well 

AhalaO 

Anion 

Ahuzzath 

Aiath 

Amasis 



Chnstadelphians 
Chuza 

Council of Jenjsalem 



_a wisely 



3. Log in i create account 



Girgasi'e 
Curium 



Nabonidus 
Nabopolassar 



Pathrusim 
Plain of Jordan 



Vieurinq all links to a paqe 

Unlike HTML-based Web sites, wiki engines are aware of every link. This leads 
to some very powerful capabilities, including the ability to quickly see all the 
links that point to a given page. This can be useful both for wiki maintenance 
as well as for finding related information. To see how link listing works, follow 
these steps: 

1. Visit Wikipedia and view the article on Ward Cunningham, the inven- 
tor of wikis. 

Chapter 4 shows how to find specific pages at Wikipedia. 

2. On the left side of the Ward Cunningham page, locate the link labeled 
Toolbox. 

3. At the top of the Toolbox list, click the What Links Here link. 

A list of all pages that link to the Ward Cunningham article appears, as 
shown in Figure 7-5. 
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Figure 7-5: 

Wiki engines 
can easily 
list all links 
to a given 
page. 



<*- Ward Cunningham - Wikipedia, the free encyclopedia - Windows Internet Exploi 

■ - » 1 \V ^ttD://en,wtiupedia.wgA , .*/SDeca^^ 
Edit View Favorites Tools Help 



lard Cunningham - Wikipedia the free enc 



Wlkll'HDlA 



navigation 

■ Main page 

■ Community portal 

■ Featured content 

• Current events 

• Recent changes 

■ Random article 

• About Wikipedia 

■ Contact us 

■ Make a donation 
- Help 

search 



' Upload tile 
i Special pages 



3 Sign in ,' create account |a" 



Ward Cunningham 

From Wikipedia. the free encyclopedia 



— Ward Cunningham 

The following pages link to Ward Cunning ham 



View (previous 50) (next 50) (20 | 50 | 100 | 250 | 500) 

■ Extreme Programming 

■ List of programmers 

■ Wikipedia Press coverage 2004 

• HyperCard 

■ History of Wikipedia 

■ Kent Beck 
> May 26 

■ March 25 

■ Portland Oregon 

■ UseModWiki 

■ Unified Modeling Language 

• Wiki 

■ WikiWikiWeb 
» Wiki software 

■ User Jan Hidders 

■ UserLA2 

■ CRC 

• Howard 





Lonely pages that have no links leading to them are orphans. How do you get 
to an orphan page? The only way is to jump directly to the page if you know 
its name; or you can navigate to the page displaying a list of all the pages on 
the wiki. (In TWiki, you click Index to display such a list.) Removing orphan 
pages is one of the tasks performed during wiki management, which we 
describe in Chapter 12. 



Renaming all links in a Web 

Another extremely useful wiki feature is the ability to simultaneously rename 
a page and all the links leading to that page. TWiki probably has the best 
implementation of this feature. There, you can rename a page and all the links 
to that page in one command. TWiki.org not only searches the web in which 
the page resides but all webs run by the wiki engine. To rename a page in 
TWiki, follow these steps: 

1. Scroll to the bottom of the page in question and click More Topic 
Actions. 

TWiki displays a More Actions on Topic page. This page lists a variety of 
actions you can take, including deleting and renaming pages. 
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2. Click the Rename/Move Topic link that specifies that it looks for refer- 
ences in all public webs. 



ki displays a page where you can rename the page. 



the Topic Name field, enter the new name for the page and click the 
Rename/Move button. 

TWiki changes all the links as well as renames the page. 

On some other wikis, the process is a bit more complex. If you rename or 
move a page on MediaWiki or WikiSpaces, for example, links to the old page 
are redirected to the new page. You must manually change each link to skip 
the redirection step. Confluence, a commercial wiki, behaves like TWiki and 
changes links automatically (and the process is also a little easier; you 
rename right from the editing page). 



Linking Outside \lour Wiki 

The creators of wikis try to provide all the information a reader needs, but 
there are always good reasons to link to information outside your own wiki. 
In the following sections, we introduce you to many different ways to create 
external links. 



Linking URLs 

The surefire way to link to a Web site outside your wiki is to use a URL, which 
is the common Web site address that usually looks something like this: 

http : / / anywebsi te. com/anydirectory/anypage . html 

Most wikis recognize URLs as links. In some wikis (such as MediaWiki), you 
need to type single square brackets around URLs like this: 

[http : / / anywebsi te . com/anydirectory/anypage . html] 

When a page containing a URL is displayed, it automatically links to the URL's 
destination. In many wikis, URL-generated links are followed by special icons, 
as shown in Figure 7-6. These icons tell you that if you click the link, you will 
be taken to a location outside the current wiki. 
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This icon indicates the link takes you outside the wiki. 




Figure 7-6: 

Arrow icons 
indicate 
external 
links on 
most wikis. 
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Linking beWeen Wikis using 
InteruJiki names 

Wikis often link to other wikis. In the early days of wikis, this was done by 
using long URLs, which worked like any other external link. This became a bit 
tedious because it meant entering long URLs every time you wanted to link to 
other wikis. 

To solve this problem, Interwiki link prefixes were created. Prefixes identify 
the external wiki to which the link points. Interwiki prefixes are unique. The 
Interwiki name for BibleWiki, for example, is BibleWiki. The format of an 
Interwiki link is the same as a normal free link except that the Interwiki name 
is used as a prefix. So, instead of entering this URL to get to the Book of 
Deuteronomy page: 

http : / /bible . tmtm. com/wiki /Book_of _Deuteronomy 

you enter a wiki free link, prefixing the page name with the Interwiki name 
and a colon, like this: 

[ [BibleWiki : Book_of_Deuteronomy] ] 

Most wiki engines that use Interwiki prefix names put external link icons after 
the link (refer to Figure 7-6). You can find the list of Interwiki link prefixes at 

http : / /meta . wikimedia . org/wiki/Interwiki_map 
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Linking to other u/ebs and namespaces 



ikis are often organized into webs (sections or subsets of a wiki). 
i.org wiki that was used to write this book, for example, has more 
than 30 webs. Sometimes linking from one web to another is useful. TWiki.org 
handles cross-web links by using prefixes. To link to a page in a web called 
Otherweb, enter 

[ [Otherweb. PageName] ] 

This link takes you to the PageName page in the Otherweb web. 

Some wikis have multiple namespaces, and the exact method for linking across 
namespaces varies with each wiki. In MediaWiki, for example, you prefix the 
page name with the namespace name, like this: 

[ [Help: Link] ] 



Linking to Files, Images, and Multimedia 

One of the least standardized but most valuable wiki linking tools involves 
attaching files to pages, including images and multimedia. Like with many 
things about wikis, the general approach to attaching files or inserting images 
is pretty much the same for most wiki engines, but the details are vastly dif- 
ferent. The basic similarities include 

Most wiki engines allow file uploads. Sometimes, the files are attached 
to individual pages (like at TWiki.org). Other times, they are put in a cen- 
tral area (like at MediaWiki, PBwiki, and WikiSpaces). 

f* Images are uploaded as files and then can be linked to from wiki pages. 

V Multimedia elements are included via URLs, JavaScript, or both. 

These links bring videos or advanced functionality, such as calendars, 
into pages. Some wikis use wizards to help add such elements to pages. 

In Chapter 1, we introduce you to PBwiki and the wikisf ordummies . 
pbwiki . com site that can be used as a sandbox. If you don't have your own 
wiki, use this wiki to practice adding files, images, and multimedia elements 
to wiki pages in the following sections. We point out some of the differences 
between various wikis along the way. 
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files to a wiki page is much like attaching files to an e-mail in that 
lly just click an Attach Files button and then browse to the desired 
file. Wiki file attachments are particularly handy if you need to share PDFs or 
other file types with other wiki members. In PBwiki, the easiest way to attach 
files is to use the point-and-click editor. Follow these basic steps, which are 
similar in most wikis: 



1. Create or open a PBwiki page to which you want to attach a file. 

If you open a page, click Edit Page to display the page in the editor. 

2. Make sure you are in the Point and Click editor, which displays icons, 
rather than the Classic Mode editor, which displays wiki markup. 

The link in the upper-right corner should read Switch to Classic Mode. 
If it reads Point-and-Click Mode instead, click that link to go to Point-and- 
Click Mode. 

A page like the one shown in Figure 7-7 appears. 



Figure 7-7: 

Open your 
PBwiki page 
for editing. 
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The editing toolbar has three buttons that are of interest to you (as 
shown in Figure 7-7): 



Attach File: Click this button to attach a file, such as a PDF or a ZIP 
archive. 

• Insert Plugin: If you have a plug-in to use with the wiki page (see 
Chapter 14 for more on plug-ins), click this button to attach it. 

• Insert Image: Click this button to insert an image. 

3. Click the appropriate button for the type of file (file, plug-in, or image) 
that you want to attach. 

A screen like the one in Figure 7-8 appears. 



Figure 7-8: 
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you want to 
attach. 
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4. Click the Browse button and then navigate to the file that you want to 
upload. 

5. Choose the file and then click Upload. 

When the file finishes uploading, it appears in the list of the page's 
attached files, as shown in Figure 7-9. In this example, we attached a JPEG 
file containing the logo of a legendary children's soccer team in New York. 
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Figure 7-9: 
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Linking to file attachments 

Attaching a file to a wiki page is usually just the first step in making use of 
uploaded files. After attaching the file, you might want to use it in a page 
somewhere. You can always see what files have been uploaded to a wiki by 
clicking the Files button at the top of every page. 



To insert a link to an uploaded file, simply go to the Files page and hover 
your mouse over the file to which you want to link. Right-click the file and 
choose Copy Link from the menu that appears. Then paste the link into a wiki 
page. The syntax for a link in PBwiki looks like this: 



<a href ="/ f/ filename . ext " >link text</a> 
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If you're familiar with HTML, the preceding syntax should look familiar. In 
PBwiki, all uploaded files go to the /f directory. The preceding link names 
^^l^^gctory in the path to the filename. 

In some wikis — such as those running the TWiki.org engine — uploaded files 
are attached to specific pages instead of the wiki as a whole. In this case, you 
use the special variable %attachurl% to link to page-specific files. A link 
looks like this: 

<a href ="%ATTACHURL%/ filename. ext">link text</a> 

In Wikipedia, a separate namespace is used. Linking to a file looks like this: 

[ [ Image : fil ename . ext ] ] 

As you can see, you'll find variations in how different wikis handle file attach- 
ments. More advanced features — such as thumbnails, graphic sizing, and 
captions — are more complex and unique to each wiki engine. Whatever wiki 
engine you use, spend time discovering its file attachment specifics. 



Inserting images 

If you know the basics of uploading and linking to wiki file attachments, using 
images is quite easy. If you want to insert an image into your wiki page, first 
upload it as a file attachment, as we describe earlier in this chapter. 

After the image file is uploaded, click the Insert Image button on the editing 
screen of the desired page. A window like the one shown in Figure 7-10 
appears. Select the image that you want to insert and then click OK to pro- 
duce a link tag that looks something like this: 

<img src=" /f /littlepebblesB&W. jpg" border="0" /> 

After you save your edits, the image appears in the page, as shown in 
Figure 7-11. 
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Figure 7-10: 

Insert 
images into 
pages from 
this window. 



« wiklsfordummies - Editing - Windows Internet Explorer 

(3 - v httD:.'/^Aisftya>™n«s.[jbv»ib.com/nieFirstSar<)t»KPage?ectt=l 
Fie Edit View Favorites Tools Help 



*? A tmk to files PBWfc 



Itisfordummies ■ Editing 



£fc " S3 ' J p a°= • jToots - 



wikisfordummies | Editing TheFirstSandboxPage 



| % HIM Image | Q i -* Insd' Wtfljn 

» •'! • • ; fflSnw ! Q I I Attooh ntu 



This is the first sandbox page 



1 lOp«onai) Qk* Browse ', select a fia lt> uploaQ. then cdcK. Lbload 

2 Seiect a file be'5-.v then press "OK"' 
j WtepebbtesBdV/jpy 



Who is making this edit? Nam 

[S^l I Cancel | 



Figure 7-11: 

An image 
is inserted 

into a 
PBwiki 

page. 



& wiklsfordummies / TheFirstSandboxPage - Windows Internet Explore. 

■ w 'V hHD:'R.fcstOrdufrmies^ 

File Edit View Favorites Tools Help 

it & 3£|'-,t* wikisfordummies / T ■ | V newfaq 



ikisfordummies TheFirstSandboxPage 



This is the first sandbox page created on the Wikis for Dummies web on PBWiki. 
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Before clicking OK to close the Insert Image window and insert the image, 
right-click the image (Control-click, Mac) to access advanced options and 
rpreges, such as size and alignment. 



Linking to multimedia 



Links to multimedia files — such as MP3s, movies, or YouTube videos — 
work much like links to images. You either upload the files and then link to 
them, or link to the source from which the videos are streamed. Multimedia 
links are also frequently associated with inserting advanced features, such as 
calendars or tables with lots of fancy elements. In PBwiki, all these things are 
handled by the Insert Plugin button. Click this button while editing a page to 
open the window shown in Figure 7-12. 



Figure 7-12: 
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Plugin 
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The Insert Plugin window has choices for all sorts of multimedia elements and 
structures, such as calendars, Google gadgets and maps, stock charts, Web site 
stats, links to photo sharing sites, YouTube videos, chat rooms, and more. 
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engines use categories and tags to organize and link related pages. 
Both categories and tags have the same mission: to associate pages into 
groups so that people can easily find related content. Wikipedia uses cate- 
gories extensively, and they are open to any site that uses the MediaWiki 
engine. Other wikis like TWiki.org have extensions that allow users to tag 
pages. The following sections show you how to use categories and tags in 
various kinds of wikis. 



Using MediaWiki categories 

Chapter 8 discusses categories from the perspective of a wiki designer. In wiki 
parlance, a category is a label applied to many pages so you can find all those 
pages that share the same label. Any given page can have more than one cate- 
gory. For example, the Wikipedia page about Ward Cunningham is assigned to 
the following categories: 1949 births I Living people I American computer 
programmers I Wiki I Extreme Programming I People from Portland, Oregon I 
American technology writers I Purdue University alumni. Here, our goal is to 
show how the MediaWiki engine can insert links that either put a given page in 
a category or display a list of all the pages in a category. 

Including a page in a category is incredibly easy. If you create a page about 
this book (Wikis For Dummies), and you want to include it in a category 
called Books about wikis, just include the following link at the bottom of 
the page: 

[ [Category : Books about wikis]] 

The MediaWiki engine creates that category if it didn't already exist, and then 
it includes the page in that category. So, if the category already existed, the 
page will be added. If the category didn't exist, a new category will be cre- 
ated, and the page will become the first member of the category. 

In addition to including a page in a category, you might sometimes want to 
create links to the category pages themselves. You have to be careful here 
because if you include a category link of the sort shown earlier, the page on 
which the link is included becomes part of the named category, which is not 
what you want. You just want to link to that category. To avoid this problem, 
add an extra colon in front of the word Category, like this: 

[ [ : Category: Books about wikis]] 
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Using categories is a complicated topic with lots of ins and outs. For all you 
ever want to know about categories and how to make them work, visit 



oks 



/en . wikipedia . org /wiki /Wikipedia : Categorization 
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Tags are similar to categories, but tags are intended to be a bit more inclu- 
sive. To use categories, you have to know how to use category links and man- 
ually edit them. Tags, though, can easily be entered by almost anyone. Tags 
describe topics or keywords in articles, and wiki search engines use these 
tags to rank search results. In other words, tags are pretty much the same as 
categories but they are assigned to pages differently, and you search for 
pages included in each tag differently, as well. 

In TWiki.org, the Tag-me plug-in allows you to involve users in the tagging 
process. Figure 7-13 shows how the Tag-me plug-in adds tags to the tops of 
pages. (We don't go into the process of adding the Tag-me plug-in to a page. 
See Chapter 14 for more about plug-ins.) Anyone reading the page can click a 
tag to add a vote for it, or they can use the text box to add new tags. To add 
a tag to a page, follow these steps: 

1. Select a tag from the drop-down box. 

2. Click the plus sign just to the right of the drop-down box to add the 
tag to the page. 



TWiki 



Figure 7-13: 

Tag-me 
adds tags to 
the top of 
TWiki.org 
pages. 
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Navigating by using tags is different from navigating through categories. The 
Tag Cloud plug-in displays tags, as shown in Figure 7-14. Tags with larger type 
have more pages associated with them. To use the Tag Cloud plug-in (which, 
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like the Tag-me plug-in, must be installed), you just click a word in the tag 
cloud to see a list of pages associated with that tag. 



Figure 7-14: 

Larger type 
means more 
pages. 
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Chapter 8 

e Four Dimensions 
ofWiki Design 

In This Chapter 

Structuring your wiki's content 
Creating logical navigation for your wiki 
Filling the blank pages 

Dressing up your wiki with colors and graphics 



m ■ esigning a wiki means putting together all your wiki skills and knowledge 
w*f to create a useful form for your wiki. The best wikis look a lot more like a 
Volkswagen Beetle — that is to say utilitarian — than a sleek Ferrari, but they 
are beautiful all the same. Ideally the design of your wiki should help people 
find what they want and join the content creation process if they feel so 
moved. To help you create such a design, throughout this chapter, we discuss 
the four dimensions of wiki design: 

1: Find the right structure for your information. When designing your 
wiki, the key thing to remember is that the structure of the information 
being captured must be in charge. Information architecture — taxonomy — 
is a fancy name for organizing the content of your wiki. Whatever the name 
you give this process, finding the right structure for your information is 
the secret sauce to making a wiki sing. 

2: Create a clear way to navigate a wiki. Everything you see when you 
encounter a wiki, from the front page to all pages deeper inside, must 
keep reminding you where you are, what sort information you're looking 
at, and how you can find your way around. Of course, the reason to navi- 
gate a wiki is to find just the right page that has the information you want. 

3: Design the structure of the pages. Use the techniques shown in 
Chapters 6 and 7 (which cover content and linking, respectively), but also 
employ the benefits of the page template. Templates, by nature, ensure 
consistency in a user-friendly way. 
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4: Adjust colors and fonts, adding images where needed, to make your 
wiki pleasing to the eye. Use themes and colors to give visitors visual 
about organization and navigation. By adding logos and other graph- 
elements, you personalize the wiki as well as make it unique. 



Designing a wiki is an ongoing process. Wikis were made to be changed. The 
design that you start with should be improved as experience and ideas from 
those using the wiki point to ways to make it better. This chapter gives you 
the conceptual foundation of a well-designed wiki so that you can quickly get 
your wiki up and running and then have the fun of redesigning it over and 
over again. 



Architecting the Information 
in \lour Wiki 

In Chapter 1, we introduce the idea of index cards to explain wikis. (The gist is 
this: If you have a box of index cards, you can add cards to the box, remove 
them, search through them, change the information on them, and so forth. 
Likewise, you can do the same with information on a wiki.) Information architec- 
ture is all about how many types of cards you have, how they are related, and 
what to write on each card. But what good is a box of cards if you can't find the 
card you want? Taxonomies, effective patterns of linking, and clear page names 
(all covered in this section), are the foundation of a well-organized wiki. Having 
the information architecture show up on the front pages and section front 
pages of your wiki makes your wiki easy to navigate. We cover that in the fol- 
lowing section. 



Understanding uriki taxonomy 

One way to begin organizing your wiki is to act like a biologist. Biologists love 
to classify things. They're not satisfied with calling people humans; instead, 
they call us Homo sapiens. Biologists systematically classify the animals and 
plants in our world by using taxonomy. Taxonomy is a way to classify things 
based on their relationships to one another and is a key part of any good 
information architecture for a wiki. 

Taxonomy has nothing to do with that stuffed moose head hanging on the 
wall. (Still, those folks who attend the National Taxidermists Association 
probably know the difference between Antilocapra americana and Antilocapra 
anteflexa, which are taxonomic names for different families of pronghorn 
antelope.) Flashback to high school biology class: Each species belongs to a 
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Prof. Tufte's design advice 



fofessor emeritus at Yale 
University, taught courses in statistical evi- 
dence, information design, and interface 
design. Over his long and continuing career, he 
wrote many books on the design and display of 
graphical information. Prof. Tufte also periodi- 
cally teaches a wonderful course that includes 
one piece of advice so valuable that it should be 
the foundation of your approach not only to 
designing wikis but designing pretty much 
everything else. 

Prof. Tufte says that ratherthan seeing design as 
a problem of invention or a challenge to create 



something new, look at design as a research 
problem in which you find something that already 
works to copy. Boy, does this approach make 
design much easier, and it fits rightintothe open 
source, evolutionary ethos of wikis. 

So, in reading this chapter and considering how 
to designyourwiki, don'tfeel nervous and pres- 
sured that you have to come up with something 
new. Rather, think about the wikis you like most 
from Chapter3 orotherwikis, books, or content 
that you enjoyed. Take a look at Tufte's books. 
Copy what you like and then improve it as you 
gain experience. 



genus; each genus belongs to a family; each freshman can't wait for summer 
vacation. (It is high school, after all.) 

With wikis, the equivalent of species and genus are wikis, webs, and pages: 

Wiki: A wiki is usually defined as all the pages under the umbrella of one 
domain, such as www.mywiki . com. 

Web: A web is a self-contained group of pages inside a wiki, which are 
intended to be linked. Linking pages across a web usually requires some 
special notation. 

Page: A page is a unit that is edited and displayed. A page contains text, 
images, and any other content included in the wiki. 

If a wiki followed the hierarchical organization of species used in biology, it 
would look something like this: 

Wiki 
Web 
Page 

Okay, that's easy enough for the average Homo sapien to grasp on a concep- 
tual level. So how, exactly, does the concept get turned into reality? Simple! 
Just think of how the project you are involved with is organized already. 
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Inside a web, the pages can be grouped in many different taxonomies. In a pro- 
ject management wiki, for example, each project can have its own web; or, one 
have many projects, each with its own group of pages. (A project is 
you might undertake, from compiling a Girl Scout troop cookbook to 
coordinating a Harley-Davidson club road trip to writing a grant for the study 
of penguin mating patterns.) Or, for a wiki on The Beatles, each album might 
have its own web, and each web might have a group of pages dedicated to 
each song. Wikipedia uses a set of basic topics, as shown in Figure 8-1. 
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j Philosophy and thinking 


Basic 


Art and culture 


. A' Mathematics and abstractions 


Religion and spirituality 


topics for 


. R Geography and place* 


Natural sciences and nature 


Social sciences and society 


Wikipedia. 


^ Health and mness 


4^ People and sell 


_J Technology and applied sciences 



Each of these basic topics is a web within Wikipedia. Because of the sheer 
scale of Wikipedia, these webs also have sub-webs for subtopics, as shown in 
Figure 8-2. 



Figure 8-2: 

A Wikipedia 
topic uses 
subtopics. 



^ Social sciences and society Nit] 
Mam list: List of basic science topics 

Social sciences ■ Archaeology • Critical theory • Economics • Geography • History • Linguistics ■ Law • Political science • 
Psychology « Sociology ■ Relationships 

Society « Community • Criminal justice ■ Firefighting ■ Law « Politics (By country) • Public affairs 
Business ■ Economics (By country) • Finance • Management 

; J Technology and applied sciences Nit] 

Main lists: List of basic science topics, List of basic technology topics and List of technologies 
Artificial intelligence • Agriculture ■ Architecture ■ Big Science ■ Communication • Computer science (Information technology. 
Internet. Programming, Software engineering) ■ Energy development • Engineering • Firefighting • Health science ■ Industry • Library 
and information science • Management • Manufactunng • Military • Nutrition • Robotics • Space exploration • Telecommunication 
(Internet) • Transport (By country) ■ Vehicles 



Suri/eyinq common uriki taxonomies 

One of the biggest favors that you can do for yourself is to use a taxonomy 
that everyone using the wiki already knows, clearly depicting the taxonomy 
on the front page of the wiki. You can see an example in Figure 8-3. Here are 
some popular taxonomies used to organize the pages inside wikis: 
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Whole, parts, and subparts: Many things that wikis track have natural 
groupings to them. For example, albums have songs, books have chap- 
L/^f*' s °ft ware nas different menu areas and screens, and cars have 
ftpg^es and models. Content-focused wikis of the sort described in 
Chapter 3 usually are organized around the natural groupings of the 
topic being discussed. For example, the front page of the Case Western 
Reserve University Wiki (http : / /wiki . case . edu) shows several cate- 
gories (People, Academics, Organizations, Campus Life, Around Case, 
Other Categories), each with subcategories listed. 

v 0 Organizational chart: The boss is at the top, and every department that 
reports to her branches outward, like a big, happy family tree. This is an 
effective structure for smaller internal wikis that are being used primar- 
ily for project management or are otherwise process-focused. 

it* Actions in a sequence: Open an order, place a bid, add data — this type 
of taxonomy is useful for process-focused wikis. For the wiki used to 
write this book, we have a list of pages that mimic the steps taken to 
write a book: project management and planning, content design, 
research, interviews, and writing. 

V Alphabetical or other natural order for a list: When in doubt, use A-Z. 
Topics, projects, webs, and registered users can all be organized this 
way and be quite effective in steering visitors to their destination. If a 
natural order to the content exists that would be easily recognized and 
understood, use it. For example, BibleWiki, (http : / /bible . tmtm . com) 
has a list of the parts of the Bible and a list of the books in each part. 

i>* Timeline: Whether you're engaged in a project on the history of the 
species or one that has distinct phases and a strict deadline, organizing 
the pages in time order can help keep everyone on track and on time. 
For project management applications, this can mean having a list of all 
the steps taken on the front page. For a research project, the timeline 
could show the events of the topic being discussed it chronological 
order. WikiTimeScale (www.wikitimescale . org) is a good example. 

Order of importance: An old-fashioned to-do list is a good way of draw- 
ing the user's attention to the most important topics or projects on a 
wiki. This is a great structure for a punch list of items to be completed at 
the end of a project. 

i>* Geography: When the information you're organizing is associated with 
regions, states, countries, or other geographical boundaries, use that to 
your advantage. For example, Wikitravel (www. wikitravel . com) 
divides its contents by continents. 
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i Reference Bullpen 



Categories 



Figure 8-3: 

Choose a 
taxonomy 
that fits 
your wiki. 



Leagues and Teams 



Players 



History 



Culture 



Glossary and 
Statistics 



- Leagues 
-Teams 

- Minors 

- Minor League Teams 

- Negro League Teams 

- Nippon Pro Baseball Teams 
- AAGPBL 

- International Baseball 

- Amateur Baseball 



- Players 

- Hall of Famers 

- Minor League Stars 

- Minor League Players 

- Negro League Players 
-Nippon Pro Baseball Players 
-Women of Baseball 

- Fictional Characters 

- Baseball Families 
-Veterans 

- Olympians 



Personnel 











— *- Managers 




— Owners 




— *■ General Manage 


rs 


>- Coaches 




— *- Executives 




>- Umpires 




— >- Minor League M 


anagers 


— >- Broadcasters 




>- Other People 





— >- History 




Postseasons 




— *■ Years 




— >- Dates 




— *- Ballparks 




—>- Awards 




— >■ Numbers 




— >■ Business 



- Books 
-Authors 
-Writers 

- Media 

- Movies 



- Glossary 

- Instruction 

- Rules 
-Statistics 

- Sabermetrics 

- Frivolities 

- Places 

- High Schools 

- Schools 
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These taxonomies cover most cases. Your wiki might end up following one of 
these taxonomies, a combination of several styles, or even another taxonomy 

Don't over-think your taxonomy. It should be a natural fit for the information 
that you're organizing. The goal is that when users of your wiki arrive at the 
front page, they should know exactly where to go to find what they need. The 
easiest way to do this is to build on a structure they already know. Put yourself 
in the mindset of a user and make a mental picture of what the front page 
should look like. Also, remember that wikis are inherently organic. Start simple, 
study the patterns of usage, and add structure in iterations as needed. 



Linking in patterns 

Think about the different ways in which people will want to access informa- 
tion on your wiki. 

For example, suppose you're creating a wiki on The Beatles. Depending on the 
depth of the content, you probably need page albums that have all the descrip- 
tive information for each respective album, and another type of page that has 
information for each song. Such a structure allows all sorts of flexibility: 

v 0 Create separate pages for two versions of the same album and then link 
to the individual song pages for songs shared by each album. 

Create playlist pages that have lists of links to song pages. As many 
playlist pages can be created as you like without duplicating the song 
pages. 

i>* Link to an individual song page when you discuss that song in other 
locations on the site. Using such links draws people into finding more 
content on the wiki. 

Create pages that summarize or compile certain kinds of content. For 
example, a wiki covering The Beatles can include a page listing all songs 
written by Ringo Starr. This short but useful list could then link to the 
individual song pages. 

All this linking is possible if the information on a page is properly designed. 
By properly, we mean that the information that goes together naturally is 
grouped on a certain type of page. Understanding what goes together natu- 
rally might be easy to figure out — such as with the example of albums and 
songs — or it might be harder to determine. The great thing about wikis is 
that if you get it wrong, you can always change it later. 
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Teach your users that adding many links in wiki pages is a good thing. This 
makes it easy to find related content. Make frequent use of WikiWords, which 
I automatically to pages of that name. (See Chapter 7 for more on 
dWords.) 



maxes 11 e; 
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What's in a page name) 

A successful wiki will quickly grow many content pages. Correctly naming con- 
tent pages allows you to create links easily, makes pages easier to find, and 
lays the foundation for certain types of automation discussed in Chapter 14. 

Suppose that you're creating a project management wiki. On the one side, 
having consistency on your wiki is a good thing. Say that Project A has a 
schedule yet Project B features a calendar: Both pages do the same thing — 
that is, track important dates — but things can get confusing for the user. 
When you have multiple pages on a wiki with similar, interchangeable names, 
it can inadvertently sow the seeds of mass confusion. To understand why, 
just think of what happens when you enter the word schedule into your wiki's 
search engine. It spits back a list of pages titled Schedule, but you have no 
clue to which project each schedule relates. 

Hence the need for good naming. Remember those biologists and their tax- 
onomies? They use Latin because it's descriptive — you know that Antilocapra 
americana and Antilocapra anteflexa are related just by reading the name. The 
pages on your wiki should work that way, too. Okay, you don't have to name 
your pages in Latin, but the name of the page should hold the key to decoding 
the page's specific contents. Table 8-1 identifies several common patterns that 
appear in wiki page names. 



Table 8-1 


Common Patterns for Page Names 


Page Name Pattern 


When Used 


WidgetSchedule 


The Widget prefix defines several types of 


WidgetCalendar 


documents related to the Widget project. 


WidgetJournal 




ProposalNewcorp20070228 The date suffix identifies a version. 


Contacts External 


The Contacts prefix identifies the type of 


Contactslnternal 


information, and the suffix divides it into a group. 
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an always hide the page's true name through linking. For example, if you 
a page ProjectASchedule20060928, but all you want the user to see is the 
^feec/u/e, link it like this: 

rojectASchedule20060928] [Schedule] ] 

See Chapter 7 for more on creating and formatting links in wikis. 

Webs can also be a source of naming ambiguity If you find that multiple webs 
have the same name, the problem is likely that the web names aren't general 
enough. In other words, the webs are being named as if they were topics. 
Consider the word Schedule again. Even if the web is a collection of important 
company-wide dates, it is better to name it descriptively, such as Holiday 
Schedule or Human Resources Schedule. 
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Plotting Navigational Paths 
through \lour Wiki 

When designing wikis or Web sites, navigation is the term used to describe how 
information architecture is presented to users. The navigation for your wiki 
includes the links that appear on the three sorts of pages in every wiki: the 
front pages (including the section and category pages), the content pages, 
and the supporting pages. Front pages and section front pages summarize the 
information in various groups of pages and tell you how to find what you need. 
Supporting pages describe the process of creating content. Graphics and 
colors make everything look pretty and clear. Navigation also includes headers, 
footers, and the left-hand side of content pages. By following Prof. Tufte's 
advice and using proven navigation models, you can find the right structure for 
your home page in no time. (See the sidebar, "Prof. Tufte's design advice.") 



besiqmnq the front page 

The front page of your wiki is the first thing that people see when they arrive, 
so it better tell them right away what the wiki is all about and how to find 
what they're looking for. To design an effective front page, start by asking 
yourself some basic questions: 

Is your wiki content- or process-focused? Or do you have a community 
wiki or some sort of brochureware? (See Chapter 3 for more on wiki cat- 
egories.) Depending on the type of wiki you're designing, the content, 
process, community, or product should be the star of the show on the 
front page. 
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lives 

DBooks 



v 0 Will people who arrive at the wiki know how the wiki fits into their 
lives? If this is a project management wiki inside a company, everyone 
g the wiki might know what it is before they arrive. If it's a content 
on the web, you might have to explain the wiki's purpose. 



i>* Will people arrive at the wiki knowing their own role? If you want 
people to contribute, you must ask them to do so on the front page. If 
they're just looking for information, you must tell them how to find it. 

t<" How nerdy are the users of the wiki? Do they know all about wikis and 
how to use Web sites, or are they newbies? Skilled Web surfers are more 
familiar with the conventions of interactive design. For example, they 
intuitively understand how to browse a long list of links as a result of, 
say, shopping at Amazon.com. 



The answers to these questions will illuminate the proper design of your 
front page. 

Fundamentally, your front page must tell visitors how to use your wiki. The 
front page is your billboard that people see as they drive by. It shouldn't be 
subtle. It should grab the reader's attention and yell out the wiki's purpose. 
Some examples of what should be on the front pages of wikis include the 
following: 



A content-focused wiki seeking input from new users: This should say 
clearly what content is being created on the wiki and how the content is 
organized, providing interesting examples to inspire people. If the con- 
tent-focused wiki is just getting started, the front page should spend 
more time recruiting new contributors and provide links to instructions 
on how to contribute content. If the wiki is well established, perhaps 
appeals for donations are more appropriate. The BibleWiki home page 
shown in Figure 8-4 touches all these bases. 

A process-focused wiki used for project management: This should start 
with a clear list of all the projects on the wiki. If the population using the 
wiki is really nerdy, not much needs to be explained. If this wiki intro- 
duces project management to a bunch of newbies, the front page should 
include a huge link to a page explaining what the wiki is all about and 
how to use it. 

V A process-focused wiki used for capturing tips on how to perform a 
task: This should clearly show the steps involved in the task. 
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Fie Edit Vie 

ipBooks 



Figure 8-4: 

The 
BibleWiki 
home page 
explains 
the wiki's 
mission and 
how to get 
involved. 




r Main Page - BibleWiki - Windows Internet Explore, 

fj • ■ " e_ hMDiy/biWe.mitm.com/v-iltiyM^Page 



Fie Edit View Favorites Tools Help 



■ _ |» Page • | j! Tools r 



navigation 

■ Main Page 

• CommunrW ooriai 

■ Recent changes 

■ Random page 

■ Help 

■ Donations 

search 



] Go | [ Search | 
toolbox 

• What linKs here 

■ Related changes 

■ Upload Hie 

• Special pages 

■ Printable version 

• Permanent link 



3. Log in ■ create account [X 



isfon | edit hislor, 



Main Page 



Welcome to the Bible Wiki! 



About BibleWiki 

The Bible Wiki is an on-going project to build a 
user-created free scholarly commentary to the 
entire text of the Chnslian Bible 



User Created 



[edit] 



This site is a wiki - meaning that anyone can 
create an account and edit almost any page If you 
see an error on a page you can correct it instantly 
Or if you want to add new content you don't need 
to ask for permission first - you just go ahead and 
create it 



Free 



The commentary is licensed under the :-f|U Free^, 
Documentation Lj:?nse sometimes known as 
copyteft That is to say it may be copied modified 
and redistributed freely so long as the new version 
grants the same freedoms to others and 
acknowledges the Bible Vfflti authors (a direct link 
back to the article satisfies our author credit 
requirement) The Wiki Bible will therefore remain 
free forever and can be used by anybody subject to 



Work in Progress 

Much of the work to date on the Bible Wiki has 
been adding seed matenal to the site Pages 
have been created for each Verse with multiple 
translations added for most books Information 
has been added from several out-of-copynght 
Bibte Dictionaries and we have recently begun 
scanning and uploading commentary from the 
early 20th Century volumes of the International 
Critical Commentary 

How To Help Nt| 

Pick a Bible verse Add information about it 
That s all there is to it Although we have high 
aspirations for what the site will become over 
time at this point it's mostly a clean slate Even 
a couple of lines of notes on each verses is better 
than nothing at all. as other people will be more 
inclined to modify text where they feel they can 
add something, than to try tc wnfe an entire 
article from scratch 



Hebrew 
Bible / Old 
Testament 

• Genesis 

• Exodus 

• Leviticus 

■ Numbers 

• Deuteronomy 

■ Joshua 
i Judges 

• Ruth 

» 1 Samuei 

• 2 Samuel 

• t Kings 

■ 2 Kings 

■ 1 Chronicles 

■ 2 Chronicles 
» Ezra 

i Nehemiah 

■ Esther 
t Job 



Hphraw Tpyt 



[edit] 



f A community wiki: This should have a front page that reflects the inter- 
ests of the community. If the community is all about events, a listing of 
events should be right up front. If it is about educating people on a topic 
or issue, that topic or issue should be most prominent. 

A brochureware wiki: This need not explain that it is a wiki at all. Small 
businesses that use wikis to publish Web sites just need to display their 
products and services and provide contact information. 



There is no single right or wrong way to design your front page. The goal is to 
start with something simple and then let the design emerge organically as the 
wiki is used. In some cases, the organic design of a wiki might not become 
obvious until after it's being used regularly and you hear complaints or ideas 
from the user community. Changing the front page is a cinch — just click Edit 
and redesign it to fit your needs. Three days or three months later, it might 
be time to change the front page again based on new feedback from the 
users. This is part of the natural evolution of a wiki. 
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besiqninq section pages 



iki grows, the number of categories of information that it tracks will 
and quickly. One project becomes many, and you can branch out 
into whole new areas. 

Section pages are the home pages for each category in a particular web of 
your wiki. Section pages provide more detail about specific topics. 

Section pages can be used in all sorts of ways: 

o* For a content-focused wiki, you might have one section for each basic 
topic. Figure 8-5 shows a section page for branches of technology at 
Wikipedia. This section page serves as a portal to various technology 
topics. 



Branches of technology 



[edit] 



Figure 8-5: 

Use section 
pages for 
portals to 
topics. 



Types 


Major field; 


! of technology 




Applied science 1 


Artificial intelligence | Ceramic engineering | Computing technology | Electronics | Energy 
Engineering physics I Environmental technology | Materials science | Matenals engmeennc 
| Nanotechnology | Nuclear technology | Optical engineering 


Energy storage | 
| Microtechnology 


Athletics and 
recreation 




Camping equipment | Playground | Sports | Sports equipment 




Information and 
communication 


Communication | Graphics | Music technology | Speech recognition | Visual technology 


Industry 


Construction 


| Financial engineer! 


ig | Manufacturing | Machinery | Mining 




Military science 




Bombs j Guns and ammunition | Military technology and equipment | Naval engineering 


Domestic / residential 


Domestic appliances | Domestic technology | Educational technology | Food products 


and production 


Aerospace engineering | Agricultural engineering | Bioengmeenng | Biochemical engmeenng | 
Biomedical technology | Chemical engineering | Civil engineering | Computer engineering | 
Engineering Electrical engmeenng | Electronics engineering | Environmental engmeenng | Industrial engineering | Materials 
engineering | Mechanical engineering ] Metallurgical engineering | Nuclear engineering | 
Petroleum engineering | Software engineering | Structural engmeenng | Tissue engineering 


Health and safety 


Biomedical engineering | Bioinformatics | Biotechnology | Chemmformatics | Fire protection technology | 
Health technologies I Pharmaceuticals | Safety engineering 


Transport 


Aerc 


space | Aerospace engineering | Marine engi 


neenng | Motor vehicles | Space technology I Transport 



f* For a brochureware wiki, you might have a section page for each type 
of product or service that your company offers. 

**" For a content-focused wiki, you might have a section page that shows 
how to contribute content, such as the TaxAlmanac page shown in 
Figure 8-6. 
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^ TaxAlmanac TaxAlmanactQiJicfc Stan Guide Join in - Windows Internet Explorer 

- HhttD^'/^'A'A.taxalmanac.org^n^x.projTaxAlmanacrQijick.StafLGuide^Joirijri 
^^^^ Fie Edit View Favorites Tools Help 

pBooi^ 



Figure 8-6: 

The 

TaxAlmanac 
wiki shows 
the steps for 
joining and 
adding 
content. 



hi * 



tnanac ■ TaxAlmanac Quick Start Guid 



"JQ 
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TaxAlmanac 



A Free Online Resource 

navigation 

• Main Fade 

■ Research Resources 

- Start new Article 

• Community portal 

• Recent cnanoes 

- Help 

■ Advanced Seaicn 



S Lag In ■ crsate account j*T 



view source history 



search 



HE) 



^Vhat llnKs here 
Related changes 

urtattn 

Printaole version 
Permanent [ink 



TaxAlmanac:Quick Start Guide - Join in 

From TaxAlmanac. A Free Online Resource 



Note You are using this vreosite at four own r,sk 
subject to our Qtsci& m ei and Weostte Use and 
Cont/iOuf.o'i Terns . 



1. Introduction 2. Cr eate a username 3. Introduce yourself 4. Join in! 



Help others... 


Add to an existing article... 


Write a new article... 


■ There are unanswered questions in 


• Leam more about editing pages 


• Other TaxAlmanac members have 


the Tax Questions Discussion 


• 5tub articles are Iodics that have 


started a list of reauested ionics 


Forum Can you help? 


just been started They need your 


Can you start on 


e of these? 


Find out more... 

■ Expenment with editing m the 
Sandboi 

■ Exolore our policies and 


help 1 Please feel free to add 
anything you can to any of these. 
■ Link to other TaxAlmanac articles 


• ortrvourCon 
more ideas 


nunirv Portal for 


and other Web sites 






guidelines 








■ Read what TaxAlmanac is about 









i>* For a process-focused wiki, you might have a section page explaining 
the stages that a project goes through or the roles involved in managing 
each project. 



Categorizing pages 

The repeated tragedy of wiki design is that often just when you get the basic 
structure of front and section pages exactly right, a new idea occurs to you 
for another way to organize the content. Categories are the remedy for this 
problem because they allow many different groupings of content. 

Categories are an alternate taxonomy to the one used in your information 
architecture. Categories create the equivalent of section pages that link to 
all the articles in a given category. Figure 8-7 shows the Wikipedia index of 
categories. 
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Figure 8-7: 

The 
Wikipedia 
Categories 
page has 
hundreds of 
categories. 



<S Wikipedia:Categorical index - Wikipedia. die free encyclopedia Windows Internet Explorei 

\\ iM: ' ^..j ( itapedB.org/wiW,WiWpeda:Categcficdjndex 
Edit View Favorites Tools Help 



Kjpedia Categorical index - Wikipedia tire 



navigation 

■ Mam page 

■ Community aortal 

- Featured content 

• Current events 

• Recent changes 

■ Random article 

• About Wikipedia 

■ Contact us 

■ WaCe a donation 

- Help 

search 
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■ uVhatnnKs nere 

■ Related changes 
• Upload We 

■ Special pages 

■ Printaole version 

■ Permanent linn 

l other languages 
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Wikipedia:Categorical index 

From Wikipedia the tree encyclopedia 

Contents • Overviews ■ Academia ■ Topics • Basic topics • Tames ■ Gtossanes • Mortals ■ Categories 



^ Reference 
'JQ Art and culture 
frU Geography and places 
Health and fitness 

;-- Reference 



Categories 

History and events 
( .r Mathematics and abstractions 
^(J Natural sciences and nature 
_ People and seft 



Of Philosophy and thinking 
^f.j Religion and Belief systems 
Social sciences and soaety 
1.3 Technology and applied sciein 



Maw categories Reseat and Lbrar, ar,d <'ifOT:ial-on scienCB 
Reference works ■ Almanacs • Atlases • Biographical dictionaries • Dictionaries 
(online) ■ Directones (online) ■ Encyclopedias (online) ■ Glossaries ■ Handbooks and 
manuals • Lists - Medical manuals • Reference works in the public domain • Style 
guides ■ Trivia books ■ Reference book stubs ■ Web sites 

Further research tools and topics * Academic disciplines • Archives ■ Books • Clients • 
Colleges ■ Curriculum • Databases (online) ■ Distance education ■ Grammar • 
Government agencies • Indices • Information • IRC * IRC clients ■ Knowledge ■ Libranes 
(digital) ■ Library cataloging and classification • Mews agencies ■ Penodic table ■ 
Prefixes • Reading ■ Research • Search engines ■ Suffixes • Topics • Universities • 
Usenet (clients) • Usenet • Writing 



51. Brier 

■VP 9 



Quick links _ 

The topmost category 
List of all categories 
About Wikipedia ? categones 
Category help 
Random category 

Category index 



Each category is a keyword tag indicating that an article is related to that cat- 
egory. For example, a Wikipedia article on Agile CMMI (a kind of software 
development) has the category tags shown in Figure 8-8. As you can see, a 
content page can be part of many different categories. Click a category name 
to link to its category page as shown in Figure 8-9. 



Figure 8-8: 

A content 
page can fit 
into several 
categories. 



Categories Software engineering | Software development process | Standards | Quality 
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Figure 8-9: 

Category 
pages list 
content 
pages in the 
category. 



Pages in category "Software engineering" 


1 


■re are 186 pages in this section of this category 










)\ 


>Q 

S^^^tg i n eenng 


C cont. 


K cont. 
















List of basic software engineenng topics 


• Continuous integration 




Kernel strearr 


ng 






■ Cntical mass (software) 




Knowledge engineenng 






■ Cross-cutting concern 




Knowledge engineers 




List Df software engineenng topics 




L 








List of software engineenng topics (alphabetical] 














■ DO-178B 




Larry Constantine 






• De Novo Software 


m 


Lean CMMI 




■ 


ATLAS Transformation Language 


■ Debates within software engineering 


a 


Le3nCMMI 




• 


Acette 


• Decomposition icomputer science} 


m 


Life-cnticai system 


> 


Actor modeling 


■ Defensive programming 




Linguistic Method 


■ 


Agile CMMI 


• Deprecation 


m 


Literate programming 




AgileCMMI 


• Derived Object 




Locality of reference 


B 


Analysis Effort method 


• Design-driven development 


M 








Application Development Facility 


■ Software development process 










Application and Data Integration 


• Bug bash 




Macro-Penme 


ensation 




Application software 


• Distributed revision control 




Management 


eview 




Architecture Tradeoff Analysis Method 


• Domain expert 




Message que 


e 




Artificial intelligence systems integration 


■ Domain-Specific Modeling 




Meta-Object Facility 




Aspect (computer science) 


• Duplicate code 




Meta-Process 


Modeling 




Auditability 


• Dynamic testing 




Meta-modelin 


technique 




Australian Software Engineenng Conference 






MetaCard 






Automated code review 






MetaEdit+ 






Autonomous agent 


• EtectntalCAD 




Metamodelinc 






Avionics software 


■ Emios 




Method stub 




B 




• Encapsulated Process Object 




Methodology 


software engineenng) 




• Encrypted function 




Modei Transfo 


mahon Lanquaqe 




Most hosted wikis and installable wiki engines have support for categories. 
Categories are sometimes called tags or tag clouds, depending on the wiki 
farm or engine. For more on categories and tags, see Chapter 7. 



Planning headers, footers, 
and (eft-hand navigation 

With front and section pages, you can guide the user to certain parts of your 
wiki. But how do users get around after they arrive at content pages? As you've 
probably already seen, most wiki pages have links all over the place. As users 
click link after link, they can easily get lost, so the wiki needs some parts of the 
information architecture available on each and every page. Headers and foot- 
ers provide this architecture on every page of the wiki. Left-hand navigation — 
the column of links often found on the left side of the screen — can do the 
same thing, or it can also provide links that are related to the current page. 
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Manually generate headers and footers for every page on your wiki is silly. 
Most wiki engines help you template or automate headers and footers. For 

sider how you want your headers and footers to look as well as how 
enhance your wiki. We discuss templates later in this chapter. (See 
UsingTemplates to Design Content Pages.") 



Now you can see how Prof. Tufte's advice can help you. (Read the sidebar 
on his work, elsewhere in this chapter.) Go to the wikis that you like. Look at 
what links and other explanatory information are in the headers, footers, and 
left-hand navigation. Make a list of the links you think would work for your 
site. Whenever you face another design issue, rinse and repeat. 

The following sections show a few of the many well-oiled ways to use head- 
ers, footers, and left-hand navigation. The TWiki.org site — which is used 
as an example here — has been created over a period of eight years and has 
been honed to be as useful as possible. If you are going to follow Prof. Tufte's 
advice to follow proven examples, TWiki.org is a great example to copy. 
Plenty of other header designs could better fit your topic or web. Browse the 
wikis and Web sites that you admire, examine their navigation, and copy what 
works for you. 



Usinq (eft -hand navigation 

Wikis tend to follow the design conventions used by Web sites all over the 
Internet. Take a look at the TWiki.org page shown in Figure 8-10. Note that 
most of the links shown in Figure 8-10 are common to many wikis. The left- 
hand navigation links serve general housekeeping functions and include 

Support Web: These are links to the home page of the support web, 
allowing users to return to a known page from any location. 

*** Support Guidelines: This page explains general support practices. 

f Open Questions and My Questions: These list support questions from 
the individual user and from other users. 

W Search: These give quick access to the search page. 

t<" Changes: These show recent changes to the wiki. 

V Subscribe: These allow users to sign up for the wiki's RSS (really simple 
syndication) feed. 

i>* Notifications: These allow users to sign up for e-mail notifications about 
changes to the wiki. 

Register: This sends users to the registration pages so they can create 
an account. 
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Left-hand 
navigation 



Tags 
for this page 



Links for editing a page, attaching 
documents, and printing 



On some hosted wikis, such as WikiSpaces and PBwiki, the left-hand naviga- 
tion is simply a special page, and customizing that page to include your own 
left-hand navigation links is very easy. You might want to add links to all the 
webs within your wiki as well as links to the sections within the current web 
for easy navigation. 



Creating effective headers 

Like left-hand navigation, headers are a Web-wide standard, and most share 
some common elements. The header on the TWiki.org support web (refer to 
Figure 8-10) has several useful features: 

The header is a great place to play Hansel and Gretel — that is, to leave 
bread crumbs. Bread crumbs — the part of the page that begins with You 
are here in Figure 8-10 — show people where they are and how to get 
back to where they came from. 

Below the bread crumbs in the header are tags for the current page. This 
is another way that categories, mentioned earlier in this chapter, are 
implemented. 

/v* In the top-right corner of most wiki headers are the Jump and Search 
boxes. Enter a page name in the Jump box and press Enter to quickly 
jump to that page. The search box allows you to search the entire wiki. 

/V Underneath the Jump and Search boxes are links that allow you to edit 
the page it text mode, edit the page in WYSIWYG (What You See Is What 
You Get) mode, attach files to the page, or display a printable version of 
the page. For more on using these features, see Chapters 2, 6, and 7. 
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The key to getting your headers correct — or any part of your wiki naviga- 
tion for that matter — is understanding how people use the wiki. Can every- 
[ what they need? That's great; maybe you don't need to update your 
)r other parts of the navigation. If people can't find things they need, 
though, perhaps links to those materials should go in the header or other 
parts of the navigation. One way to listen to user input is to make sure that a 
link that provides feedback is prominent on all pages of your wiki. 
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Planning footers 

The footer of each page is another functional space. Because the user is at 
the bottom of the page, he is likely to want a different set of functions than 
what he had at the top of the page although some navigational elements like 
bread crumbs should show up in both headers and footers. Figure 8-11 shows 
what the footers look like at TWiki.org. This footer contains the most 
common elements of a wiki footer, including these: 

i>* Edit, WYSIWYG, Attach, and Printable links are repeated from the 
header. These are the most commonly used links, so having them in the 
footer adds convenience because people don't have to scroll back to the 
top of the page to find them. 

Raw View offers a way to view the underlying source code of the page. 
It is similar to the Edit button except that you can't save any changes. 
Raw View is useful if you want to copy and paste a bit of code or wiki 
formatting onto another page. 

Backlinks are links that search the web or the entire wiki for links to the 
page you are currently viewing. 

History provides links to recent versions and the changes made from 
version to version. For example, version numbers appear as r3 8 <r37 
<r3 6, with older versions linked so that you can view them. 

More Topic Actions is a shortcut to a page showing more advanced 
changes that can be made to the page you are on, such as delete, 
rename, and move. 



Figure 8-11: 
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Adding supporting pages to your Wiki 



g pages add information to the wiki to meet special needs that are 
t but necessary. Pages in the supporting cast can include any of the 



following 



Explanatory pages that tell the rules of the wiki and describe community 
practices 



v 0 Pages that describe the processes for adding content 
Site Map (an overview of all the webs on the wiki) 
Users (a list of people who use the wiki) 

Groups (a list of the project groups or business divisions using the wiki) 
Templates that show how contributed pages should look 
About Us pages that explain who created the wiki 
V 0 Frequently Asked Question (FAQ) pages 
Copyright and content licensing pages 

Although these pages aren't always the most exciting to create, they are a 
great investment most of the time because they help expand the range of 
your wiki to include newbies. Keeping up such pages is an important task in 
managing a wiki, which we discuss in Chapter 12. 

Supporting pages are one place where Prof. Tufte's design advice ("copy what 
works") applies quite well. (See the sidebar, "Prof. Tufte's design advice.") 
Supporting pages are copied from one wiki to the next all the time. Sites run- 
ning the MediaWiki engine (see Chapter 10) start off with an excellent struc- 
ture for supporting pages, including pages that solicit donations and explain 
what is happening with the community. 



Using Templates to Design Content Pages 

The content pages are the heart and soul of every wiki. Chapter 6 covers all 
the ways that content can be added to a page using bullets, tables, images, 
and other formatting ideas. Chapter 7 walks through the various techniques 
for linking pages. Ideally, after a wiki gets going, the community of people 
using the wiki keeps busy adding and adjusting pages. 
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Wikis should be flexible, not trapping content into a rigid structure. However, 
the potential flexibility of wikis doesn't mean that structure is always a bad 
hat contributors to a wiki don't want or need help creating pages, 
look at a wiki like the Baseball Reference Wiki (www . baseball- 
erence . com) or Encyclopedia Gamia (http : / /egamia . com), you see 
pages and page elements that look just like one another. If your wiki has pages 
that look the same or share common elements, it makes sense to give wiki 
contributors a leg up on creating those pages. Page templates do exactly that. 



The simplest sort of page template appears on hosted wikis like WikiSpaces, 
PBwiki, and others that focus on making wikis easy to use. Page templates on 
these sites offer a page that has headings for various sections, along with 
sample lists of bullets or table entries. Figure 8-12 shows the screen at PBwiki 
that allows you to choose from a variety of templates. 



Figure 8-12: 
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When a page is created from a template, some generic placeholder content is 
inserted in the new page, as shown in Figure 8-13. You can then fill in your 
own content for the new page. Most hosted wikis allow you to use predefined 
templates, and some allow you to create your own templates either in the 
free version or after an upgrade. 
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The idea of templates applies to parts of pages as well as entire pages. Content- 
focused wikis, such as www. Baseball-Reference . com, feature hundreds of 
parts of pages than can be included in other pages to provide links to useful 
information. For example, the Baseball Reference Wiki includes pages dis- 
cussing Major League Baseball ballparks. The page for each individual park 
includes a box with links to all the other ballparks. If this box is a template, it 
can easily be inserted on each page by entering the following text: 

{ {MLB ballparks} } 

The box shown in Figure 8-14 appears as a result of this wiki markup. 



Figure 8-14: 
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Creating templates for portions of pages is a process that varies widely 
depending on the wiki engine you're using. To get a general idea about how 
lates can be created and used, see the Wikipedia article on templates at 

ipedia.org/wiki /Wikipedia : Template_namespace. Chapter 12 
describes how to manage templates. 



\\V to Another method for populating pages automatically is to use forms and vari- 
~ ables. Forms are often filled in with variables that contain useful information, 

such as the name of the page or the name of the wiki. Forms and variables 
are discussed in Chapter 14. 



Adding Visual Panache to \lour Wiki 

Black text on a white (or off-white) background has been used by newspapers 
for centuries as the standard way of presenting useful information. It works 
for wikis, too. The information age is not bound by the physical world of ink 
and paper, though. The color and images on a wiki can convey just as much 
information as the content of the webs, topics, and pages. 

Take another gander at the Wikipedia home page. This time, go online 
(http: / /en. wikipedia.org/wiki/Main_Page) to see it in color. The 
Wikipedia front page has a blue section and a green section, and below those 
is a purple section. You know just by looking at the page, consciously or not, 
that those colors signify different sections. The page also has logos, icons, 
and photographs that make up the page's graphic design. 

Graphic design is a subtle and tricky art. People spend entire careers perfect- 
ing the balance of type, color, and imagery that appear on a page. Wikis pro- 
vide you with the basic knobs and dials to control the graphic look of pages. 
While doing it yourself, it is always a good idea to follow Prof. Tufte's advice 
and copy attractive designs. If your site really becomes popular, consider turn- 
ing to a trained graphic designer to at least give your wiki a visual once-over. 

Most hosted wikis and all the installed wiki engines allow a large degree of 
control over how pages look. Some of these changes — such as colors and 
graphics — are simple. Others — such as the ability to display your wiki on 
a cellphone or PDA screen — require advanced knowledge of things like 
Cascading Style Sheets (CSS), XSL Transformations (XSLT), and other ways of 
controlling the layout of pages. 



i 
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Using themes and skins 



;ted wikis offer a variety of visual themes to choose from. A theme, 
etimes called a skin, is a collection of all the advanced settings — 
color, fonts, backgrounds, text size, and more — combined to create a certain 
look. Sometimes themes and skins just change the colors and graphics. Other 
times they change the entire layout of a page. To change a theme on 
WikiSpaces (www. wikiSpaces . com), follow these steps: 

1. Click the Manage Space link in the left-hand navigation area. 

2. In the Space Settings section, about halfway down the page, click the 
Look and Feel link. 

3. Click the link under Themes to display the page shown in Figure 8-15. 



Figure 8-15: 
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4. Select a theme and then select the appearance of all the pages on your 
wikis changes. 
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By choosing a theme, you get a different combination of fonts, colors, graph- 
ics, and layout to give your wiki a new personality You can create your own 
n WikiSpaces and other hosted wikis, but frequently, this involves 
e to a premium version of the site for a fee. Be aware that building 
new themes and skins usually requires some knowledge of CSS or XSLT. 



Choosing color 

One of the most effective uses of color on a wiki is to assign each web its own 
color. This does not mean that all the text, background, and other elements 
of the web should be shades of, say, orange. However, giving each web a 
small colored box next to its name, and then automatically having that color 
be used in key places throughout that web, can enhance a user's sense of 
place and make your wiki look professional. 

For example, suppose that you have a wiki that's primarily used for collabo- 
ration, but a blog also resides on the wiki where users can post links to news 
articles. One way to differentiate the blog portion of the wiki from the collab- 
orative sections is to give the blog web a different background color. That 
way, anyone visiting the blog will understand that this page has a different 
purpose than other parts of the wiki. 

Note: Using color in page backgrounds should be handled with caution. It is 
all too easy to have background color overwhelm both the text and the rest 
of the page. That said, much like the use of colors to signify different webs, 
background colors on a page can be an excellent way to differentiate the type 
of information being presented. 

One way to use colors is to explicitly enter the colors you wish for table back- 
grounds or fonts, as described in Chapter 6. Hosted wikis, such as WikiSpaces, 
make color choice easier. In the Look and Feel section of the Manage Space 
area of WikiSpaces, the form shown in Figure 8-16 allows you to change colors 
used for the background, text, and links in the wiki's theme. 



Colors 



Figure 8-16: 
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Personalizing u/ikis With logos 



n't already have a logo, you probably want one. Just a simple image 
y set your wiki apart and make it more memorable. Logo design is an 
art unto itself, best handled by an artist or graphic designer. The question for 
wiki builders is not whether to use a logo but where? 



The conventional use of logos, which has been evolving since the earliest 
days of Web sites, is to place the logo in (or near) the upper-left corner of the 
page. Visit Amazon.com, Motorola, or AOL — pretty much any well-known 
Web site — to see a logo in virtually the same place on every site. Of the 
many reasons for this placement, consider this: No matter how small you 
make your browser window, a logo in the upper-left corner will still be visible. 
Suffice it to say, it's a tried-and-true place to put your logo. 

Putting your logo in the upper-left corner of every page is a simple exercise 
for most hosted wikis. In the Look and Feel section of the Manage Space area 
of WikiSpaces, for example, is a form that enables you to upload your logo. 

If you want your logo to look good, make sure it is a size that will fit into the 
area allotted for it in the wiki theme. In the themes on WikiSpaces, logos are 
150 x 150 pixels or smaller. 

Another way to spruce up your wiki is with a favicon. Favicons are favorite, 
icons, which are 16 x 16 pixels. Browsers display the small icons in the 
address bar, browser tabs, and bookmarks. Favicons help users find your 
wiki more easily. To add a favicon to your wiki, typically you upload an image 
file with the icon to the wiki and then refer to it using an HTML <img> tag. 
Some wikis, like TWiki, make this easier by creating variables that make 
inserting the favicons easier. 
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In this part . . . 

7 his part addresses the issues that you encounter 
when taking your wiki world-wide — or at least to the 
people whom you want to use your wiki. Chapter 9 pre- 
sents the playbook for attracting users to your wiki. If you 
are in an organization that can't use a hosted wiki, we 
cover that here as well. 

Chapters 10 and 11 explain choosing and installing the 
right wiki engine on your own servers. Chapter 12 explains 
how to manage a wiki, and Chapter 13 explains how to 
protect one. 

Chapter 14, the most technically advanced chapter in the 
book, explains how to add special features to create a 
structured wiki — one that can automate tasks and treat 
wiki pages like records in a database. 




Chapter 9 

Users to Your Wiki 



In This Chapter 

Wiki don'ts 
Wiki do's 

Wikis in the community and office 
The wiki life cycle 



/M s we show throughout this book, wikis are a great way to create and share 
¥ \ information in an organization or group. You set up your wiki, open the 
doors, and — like an expectant shopkeeper — keep looking out the window for 
wiki customers. But where are they? And why aren't they wiki-ing? 

Remember that new technologies take time to understand and (most impor- 
tantly) accept. Imagine the early skeptical days of movable type, radio, 
telegraph, television, and microwave ovens. Now, those technologies are 
part of everyday life. A wiki is similar. It looks like something that everyone 
understands — a word processor document — but follows a strange set of 
new and odd rules. Anyone can edit one? Anyone can erase anything in one? 
How can that be useful? 

This chapter shows you how to attract users. To attract users to your wiki, 
have your elevator pitch ready — a multisecond description of the project 
and its values. You can say something like, "With our wiki, we now have a 
great repository for all the Widget Sales Support information. I bet you want 
access." Those interested in both Widgets and Sales Support will probably 
jump at the chance. The folks in the Widget factory might not. But first, we 
talk about how not to attract users to your wiki. 



• • • • • 



• • • • • 
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wiki to a busy executive, a community member, or an average 
Internet user is an uphill battle. With a number of competing stimuli — Web 
TV, mobile phone calls, e-mails pinging in the background — your wiki won't 
get the attention it deserves unless you're able to explain its value in a few 
simple words. To paraphrase that old mountain-climbing chestnut, you can't 
convince someone to use your wiki because "it's there" (or even because it's 
just plain cool). A wiki's value directly corresponds to how well your audi- 
ence understands your goals and project. 

Your primary decision is whether you want to publicize your wiki. If the wiki 
consists of private poetry on the life cycle of the naked mole rat, your audi- 
ence is probably limited to a few biologists and fans of hairless mammals. If 
you're attempting to tackle a huge topic — The Beatles, skeet shooting, or 
training and breeding the common cockroach — you're ready to publicize. 



Don't confuse your audience 

State clearly what you wish to accomplish. Think about your first page. What 
does it include? MyCoolWiki is a horrible title because it tells the viewer noth- 
ing about your content. Comparatively, The Beatles Wiki is a great title. The 
Magical Mystery Tour Wiki is an even better title. Make it amazingly easy to 
understand what you're offering. Create a separate wiki for each project you 
work on — hey! they're free! — and don't try to do too much on one page. 

Also, encourage the use of WYSIWYG (What You See Is What You Get) editors 
for new users, and allow users to attempt using markup languages when their 
skill level is up to snuff. (For more on WYSIWYG editing and wiki markup, see 
Chapter 2.) If they can't understand what you're asking them to do, it's 
almost impossible for them to do it. 



Don't fire and forget 

The worst thing that you can do is create a wiki and expect others to update it. 
The easiest part is obviously clicking a few links and starting up your wiki. 
(To see how easy it is to start a wiki, read Chapter 5, which shows how to get 
a wiki up on a hosted wiki in a matter of minutes.) The hardest part is con- 
vincing people to use it. 
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Don't just build your wiki and send an e-mail announcing it. Take and share 
ownership of this new project and be ready to educate those who don't 

nd what's going on. Whether you're working on a Midwest Regional 
ce wiki or a Siamese Kitten wiki, you are the seed crystal around 
which everything else will coalesce. Nothing is sadder than seeing a lone 
wiki, sniffling in the rain, waiting for its owner to come back. 



Don't spam 




If people are interested in your wiki, they will stick with it after you show 
them what it is. You'll find no value in bombarding your audience with e-mails 
and reminders. Grab a few key members and teach them how to use a wiki; 
then ask them to bring others on board. If your wiki is public or part of a 
community, don't go to forums or message boards and trumpet your wiki's 
superiority. Don't visit Wikipedia and link to yourself. Wikis are made by net- 
works of like-minded people, not by angry spam victims. 

For a community wiki, talk to a few major blog and forum owners on your 
topic and ask them for help in fleshing out your project. If they see value, 
they'll quickly add to your initial progress. If they don't see value, they'll 
ignore it. Don't be pushy. In a corporate setting, grab a few close confidants 
and start your wiki. Make it a useful repository for information. Then, move 
on to other members of the team. Wikis are organic, accreting information 
and value over time. 

Don't yet the Field of Dreams syndrome 

You watched the movie Field of Dreams and took to heart the mantra, "If you 
build it, they will come." You spent hours on your logo. You posted your first 
three paragraphs inviting the world to join you on a magical ride through the 
history of fine cheeses or the Form R-55515 in the XRZ 12-12 Advanced 
Motorized Mulch Extractor Manufacturing Directives. Yet no one has con- 
tributed to your wiki, and your hits have been dismal. It seems that only you 
and Mom want to read about brie, and even she stopped visiting last week. 

Take control of your wiki and build it, but don't expect an instant audience. 
A wiki audience consists of people who trust your information and want to 
help it grow. If they happen upon your pet project and are interested, they 
will stay. Create a core group, seed your wiki, and let it grow. Don't force it. 
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The Wikitorial debacle 



s 77mestried to create an 
open forum for readers to talk back and com- 
ment on editorials in the paper. Dubbed the 
Wikitorial, it heralded a new era in journalistic 
openness — or did it? 

The result was a free-for-all of name-calling and 
nastiness that was taken down right away. The 



Internet sometimes reduces inhibitions and 
encourages our more base instincts to bare 
themselves. Therefore, use wikiswhere there is 
a chance that a cooperative community can 
form. Throwing a wiki at a controversy just 
means that you will end up with a nasty wiki. 



Don't oVerdesiqn 

The best wikis consist of a few blocks of text, an image or two, and a request 
for more updates. Of course, any text or images posted to the wiki should 
relate to the wiki's topic. Animated GIFs, pictures of your cat, and diagrams of 
the ancient pyramids, for example, don't belong on a wiki about fishing. File- 
download links and help pages should be easy to identify Explain exactly 
what each page is about at the top. Your readers will thank you. 



Don't otiermanaqe 

A wiki is like your little digital baby: It's hard to let it out into the world. You 
want to coddle it, take care of it, and make sure that no one defaces it. Well, 
relax, Mama or Papa! Wikis are designed to be constantly changing and fluid. 
If your audience wants to put up thoughts on advanced Needle-in-a-Haystack 
Finding Techniques on your procedural How to Mow the Grass wiki, let them 
go for it. You can always expand the wiki to encompass new information, or 
even start a new web or wiki. (For more on planning wikis and webs, see 
Chapter 8.) Be ready for surprises. 



Don't qo on tiiki suicide missions 

Wikis don't have magical powers. They cannot create camaraderie where 
none exists, nor can they streamline an out-of-control operation. They are not 
powerful information magnets, nor will they make your team better writers, 
more organized, or more intelligent. In short, without a strong guiding hand, 
wikis are useless. 
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Wikis cannot promise instant returns or unbelievable creativity. Wikis allow 
users to quickly and easily update and upload information. Wikis are no sub- 
r holding a meeting, contacting your team members, or doing hard 
rself. 



Wiki Oo's 

In the preceding sections, we describe what not to do when implementing and 
promoting your wiki. Avoiding common mistakes will help prevent you from 
turning people away from the wiki. Instead, take positive actions to make your 
wiki better and more popular. The following sections show you some "wiki do's" 
that will help your wiki attract users and keep them coming back for more. 



Seed your Wiki 

A useful wiki, from a user's point of view, is one that has a clear goal and some 
information already in place. Take Wikipedia, for example. When you visit a 
topic, you see a concise, hopefully coherent entry on a particular subject. If 
you find the information useful, it served its purpose, and you and Wikipedia 
can both go about your business. If you find the information lacking or incor- 
rect, you can edit the entry and expand upon it. That's how wikis work. 

But if that seed — some initial, useful information — isn't there, there is no 
impetus for others to create it. This is true with almost any page, from the 
lowliest procedural wiki to the most exalted managerial wiki. Whether you're 
creating a collaborative style sheet for a school newspaper or building an 
homage to *NSync, if you don't take the first step, we can guarantee that no 
one else will. 

To begin, create an introductory page with links to the sub-pages you expect 
to create. Writing about The Beatles? Make pages for John, Paul, Ringo, 
George, and maybe even Pete Best. Index these pages on a main page and 
explain your goals. Create a page for their discography Create a taxonomy 
(see Chapter 8 for more on taxonomies) that makes sense for you and your 
readers. Here's an example: 

Welcome to Joe's Beatles Page. Our lofty goal is to create a compendium of 
knowledge on The Beatles and their many albums. It is a wiki, which means 
it consists of a set of linked pages that you can edit simply by clicking the 
edit button. Take note, however, that wikis have a set of commands and 
formatting tags that you will need to use when adding to or modifying this 
collection. Visit our Help page to learn how to edit this wiki. 
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sual reader can understand and use immediately. 

eone "in the know" can edit and update alongside your already pithy 
and useful work. 



Remove barriers 

Getting people to understand wikis is the first step in the long slog toward 
wiki Utopia. Productivity tools have come and gone. Anything that dilutes 
our attention (except, of course, videos of kittens wearing sun bonnets) is a 
potential drain on productivity rather than an improvement. 

Your goal, then, is to make it abundantly clear that the wiki will help, not 
hinder, the average user. Here's how: 

Educate: Convincing your office mates to buy doughnuts on Friday is 
easy. Making them invest in a corporate or community wiki can be diffi- 
cult. That's why you have to be the wiki evangelist. Reply to e-mails 
with a quick note — "Hey, this looks like some great content for the wiki. 
Check it out here. ..." — and add their input in a logical place. Take a 
few hours and invite everyone into the conference room or club meeting 
place (Hint: bring doughnuts) and show them what a wiki is, how it 
works, and how easy it is to update. Wikis are like chess: They take a 
moment to learn and a lifetime to master. Who knows? There might even 
be some latent wiki savants in your group who take the project and turn 
it into something you never expected. 

i>* Instigate: Create wikis from already existing documents. Send out, by 
e-mail, the URLs to specific wiki pages instead of including the content 
of the pages in the e-mail itself. Print out a wiki entry with the URL 
prominently displayed, and pass it out at your next meeting. Flatter your 
friends and tell them, "This is going into the wiki." Do it enough times, 
and they'll either stop calling you or ask what a wiki is. Your goal is to 
make your wiki as visible and useful as possible. Don't be afraid to use it. 

W Promote collaboration: Trust networks between people can be strong 
or tenuous. If you have a good spirit of teamwork, take advantage of 
your existing trust relationships and work together on a local wiki. Then 
take it "national," as it were, by offering to make wikis for other depart- 
ments and connecting them. With a little careful connectivity, you can 
create an organization-wide storehouse of knowledge. 
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Instilling a sense of ownership and involvement is doubly important 
for personal or public wikis. With these wikis, people are contributing 
jng their (usually scarce) free time. Take advantage of your initial 
acts with fans of your topic and offer to add their input to the group 
wiki. Then, reach out to other information sources and ask them for 
input or suggestions. People love giving advice: When they see their 
advice appear in a public wiki, they feel like they've contributed. Start 
local and work your way out to a wider network. 



Encourage u/iki-users to be bold 

An old adage in computer training states, "There is nothing you can do to 
break the machine." No matter how many times you press the Enter key, 
move the mouse, or click the wrong thing, everything can be fixed with a flick 
of a switch. This is true of wikis — especially wikis with change control. Allow 
your wiki users to do whatever they want, whenever they want. Do they need 
to put up images of the internal workings of a jet engine? Help them com- 
press the images to JPEGs and start posting. Do they need to create special 
web forms for user input? Show them how to build them. It's quite easy. (See 
Chapter 7 for more on using images in wikis; for more on web forms, see 
Chapter 14.) 



This doesn't mean that your co-authors should populate the wiki with jokes, 
sound files, and pictures of puppies. Instead, it means you should tell your 
potential community members that there's nothing they can do to destroy 
the wiki. There is always a backup; no one will yell at them for posting some- 
thing; and the more information on the wiki, the better it becomes. 



Starting a Community Wiki 

Say you're starting a wiki for a personal project, club, or obsession — a 
community wiki. The goal is simple: Catalog some interesting information on 
a particular topic. Whether it's a wiki on the life cycle of the common sala- 
mander or a bowling league players roster, a wiki is a great resource for 
research and information maintenance. The following sections provide tips 
on how to make your community wiki a powerful tool. 
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the wiki with useless information. Create pages for each topic and 
focus clear and uncluttered. Begin by creating a main page and then 
branch off from there, creating a tree hierarchy (as shown in Figure 9-1) that's 
easily managed and understood. Tell your co-wiki-ers to keep it simple as 
well. Decide what your wiki is about and stick with it. 
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Figure 9-1: 
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Advertise the Wiki 

No, you don't have to buy a billboard on Route 66 to advertise your wiki. All 
you have to do is explain your wiki and share your mission with the commu- 
nity. You can easily do this in a quick e-mail to friends or in a post on a com- 
munity forum. Many potential users might not even know what a wiki is, let 
alone how it can help their cause or organize their obsessions. Explain the 
concept but don't harp on it. Discretion is the watchword — if people are 
interested, they will join you. 



Assist the Wiki 

Become the group wiki expert. Be ready to answer questions and seed content 
that might come from other channels. Why not go through a group's forums 
and bring out definitions of terms or historical references? Grab some old dis- 
cussions and create a FAQ list or glossary. Build a schedule or team roster, add 
some contact information, and show others where the information is located 
and how to edit it. Treat the wiki as an extension to your private Web site. 
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If you're creating a procedural wiki, ask for how-tos from your most active 
members. This will encourage more folks to stop by to read about your mus- 
lodel rocketry or interpretative dance. A wiki offers a more focused 
Sensed view of a procedure than a blog does. Blogs are organized by 
date and usually reflect opinions. Wikis are organized by topic. Wikis are like 
books, except that anyone can add a page at any time. Wikis are great for 
storing information. Be the person who shovels that information into the 
wiki, allowing everyone else to follow suit. 
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Promoting Wikis in the Office 

Convincing your entire knitting circle to use a wiki might be hard, but what 
about convincing an entire office? As we discuss earlier in this chapter, 
attracting users can be a lonely row to hoe, but don't despair. Your goal is to 
begin the evangelization process and hope — or wait — for the rest of your 
office to fall into line. Some ideas that might help include the following: 

*<" Begin by focusing on private wikis. Create pages for use in your own 
workspace and send those pages instead of Word documents when pos- 
sible. Obviously, sending a web page when a formal report is due might 
not be a good idea, but creating a precedent for wiki usage is key. 

If the boss asks for a report that is traditionally sent in a Word document, 
do it in Word and then make a quick copy in the wiki. Send both to your 
boss, noting that you will update the report with any changes and update 
the wiki as well. This is a win-win situation because you followed the 
letter of office law while allowing the idea of wikis to intrude on your 
boss' psyche. Of course, this will work only if you get the go-ahead from 
the right person to use a wiki in the first place. Springing wikis on a group 
without consultation can succeed, but it can also blow up in your face. 

v 0 Build templates for the office. If you pass around meeting minutes, create 
a meeting minutes template that's easy to use and understand. If you need 
to store procedures, sit down with one of the team members who is well 
versed in a particular skill or system and ask him to help you create an 
example procedural page. Create a "best practices" page for your team, 
highlighting the best of the best in your particular department. 

f* Determine where wikis will be most effective. Help desks, program- 
ming teams, and other service-oriented departments are best suited to 
using wikis. Many expensive tools such as Lotus Notes and Microsoft 
Exchange have long promised wiki-like functionality, but only with wikis 
has the simplicity of adding and cataloging information allowed that 
promise to come to fruition. 
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f Demonstrate wiki potential to the company. When you first propose a 
wiki to people outside your direct sphere of influence, they'll probably 
at you funny. You and your buddies in Accounting can finish each 
rs' sentences, but the rest of the company might not be on the same 
page. Use your existing webs of trust to pitch and grow your wiki project. 
Don't expect the CEO to start posting if you can't get the mailroom folks 
to pitch in. 



You can argue all you want — "This project will help us in the long run!" — 
but unless you create a small wiki biodome in your own department, 
no one will appreciate what you've done. By creating value in your own 
smaller environment and then — by using networks of trust — expanding 
it into other parts of the organization, you can at least be sure people 
will understand your mission and, tacitly, appreciate the effort. 

Remember the hierarchy. Just like you can't jump from department to 
department, you can't jump up the corporate ladder unless you have a 
key to the executive washroom. Pitch the wiki idea to the CEO's assistant. 
He or she can easily send the CEO some wiki links outlining procedures 
or executive decision trees and pique the higher-up's interest. 



Living With Wiki Life Cycles 

After your wiki is up and running, you can expect a wiki life cycle that will 
happen whether you're running a community or an office wiki. All wikis begin 
at the planning stage, and the following sections walk you through the normal 
life cycle of a wiki. Understanding this cycle will help you plan and implement 
your wiki as well as continue to be a key part of the wiki as it matures. The 
job of promoting wikis and encouraging their use doesn't end after they have 
successfully launched. You must keep spreading the word and helping in dif- 
ferent ways as a wiki matures. 



Deploying the u/iki 

After you have office or community buy-in for the wiki, the busywork begins. 
The initial deployment stage involves lots of fire-fighting and helping new 
users get up to speed. You'll also want to begin thinking about corporate 
branding and working with a design team to ensure that your new site 
matches the community or corporate identity. 

Work out access controls and roll-back systems as well. This ensures that the 
people who are supposed to be using your wiki have access and also that 
interlopers can't mess up your hard work. 
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Grouting your Wiki 

th phase involves getting everyone on the same page and expanding 
to other parts of the organization. At this point, you're ready to 
start repurposing old documents for use on the wiki and helping users create 
new ones using templates and other user-friendly tools. 

The growth phase lasts as long as you let it, but this stage requires care and 
pruning so that the wiki doesn't become too overgrown. 



Taming large Wikis 

A large wiki contains more than 50,000 pages. We know what you're thinking — 
who has time to read all that?! However, some wikis can become monsters — 
and the sooner you tame the monster, the better. Some key steps in that taming 
include 

f* Create a wiki taxonomy. This organizing principle is the first step in 
taming a monster wiki, which involves splitting the wiki functions into 
separate pages and webs. (See Chapter 8 for more on planning logical 
wiki taxonomies.) 

Create a glossary area. This area that includes term definitions is a key 
tool to ensure that all your wiki users speak the same language. 

Create a strong list of standard pages. Standard pages can include 
pages for participants, attachments, and chit-chat. Include standard 
pages in every wiki web to allow easy access to certain data and to 
create a predictable structure for the other webs, making it easier for 
users to navigate your wiki webs. 

v 0 Prepare a pruning system that culls dead and unused pages after a cer- 
tain period. This culling process helps prevent confusion that occurs 
when people encounter pages that perhaps don't fit into the new mission 
of the wiki or those that were started or suggested but don't look like they 
will ever take off. Perhaps a quick e-mail notification to authors would jog 
their memories when it comes to removing or fixing dead links. 

f* Consider hiring a wiki librarian. A librarian can keep everything in its 
right place and act like a switchboard operator or referee, maintaining 
order in a cluttered environment. 
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Ending a uriki's life 



is go gentle into that good night. Perhaps the wiki just wasn't meant 
maybe its department closed. Prepare yourself for expiring wikis by 
backing up wiki data and keeping it archived in a safe place. Shutting down a 
useful tool like a wiki is often heart wrenching, so be sure to think happy 
thoughts as you lock the backup disks away and shut off the wiki server. 
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oosmg an Installed Wiki Engine 



In This Chapter 

Understanding the basic wiki groups 
Deciding your wiki's purpose 
Comparing choices on the wiki menu 
Going on a wiki walkabout 



m My iki engines are the programs that run on Web servers that allow 
ww people to create, edit, and publish wiki pages. When you use a wiki, 
you use a wiki engine. The question, then, is who installs, runs, and maintains 
that engine? In most cases, that doesn't have to be you. In Chapter 5, we 
cover the easiest kind of wiki to use: a hosted wiki. With a hosted wiki, the 
people who run the hosted wiki take care of everything — installing the wiki, 
customizing it, backing it up, and maintaining the users and permissions — 
and you just sign up and use the wiki engine. Pretty darn easy. 



For some people, though, a hosted wiki just won't do. For example, if you 
work for a company that's using its wiki to create or manage sensitive infor- 
mation, you might not trust a hosted wiki to keep that information safe. Or, if 
you plan on customizing your wiki heavily and making it do the advanced 
things we cover in Chapter 14, you want your own engine so that you can 
control absolutely everything about it. No matter the reason, after you decide 
that you need to run your own wiki engine, you have to make a decision: 
Which wiki engine is the best one for your needs? 

Choosing software is never easy — sort of like deciding on a cellphone 
provider with a two-year contract. You try to do all the research to make sure 
that you make the right decision, but you never really know until you've used 
the cellphone for a while and gotten a few bills. Choosing a wiki engine often 
makes people nervous for the same reason. Instead of a contract, you implic- 
itly have a time investment to learn about the wiki engine and then to work 
with it to see whether it meets your needs. Worry not. This chapter helps you 
create a short list of wiki engines that are most likely to meet your needs. 
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rt of successfully using wikis is understanding what you and the 
people you want to work with need from a wiki. A scout troop, for example, 
has different needs from a multinational corporation. Chapter 3 describes the 
different uses of a wiki. You might find that your needs fall into one of the cat- 
egories listed there. If not, perhaps your use of a wiki will break new ground. 

After you figure out what kind of wiki you need, your next steps are to 

1. Understand the capabilities of the various categories of wiki engines. 

In this section, we give you a rundown of the wiki engine categories and 
detail when to use each. 

2. Determine the requirements for your wiki. 

The "Assessing Your Wiki Requirements" section can help you determine 
wiki needs. 

3. Explore the capabilities of all the different wiki engines that are right 
for you. 

The "Comparing Wiki Engines" and "Going on a Wiki Walkabout" sections 
can help you find the wiki engine that meets your wiki needs. 

4. Select the one with the best fit. 

More than 50 different wiki engines are available that are stable and reliable, 
and probably 25 more are in earlier stages of development. Each engine was 
created to meet a different set of needs and has a different set of features. 

Most wiki engines are distributed as open source, meaning that they were cre- 
ated by developers who wanted to share their work with the rest of the world 
instead of selling it. Unlike commercial software, open source software is dis- 
tributed without charge. (Yay! It's free.) The source code — the programming 
language files used to build the software — is also available free of charge. This 
open source model means that anyone with a good idea can pick up the source 
code and improve the software. Unfortunately, sometimes open source software 
doesn't come with all the documentation, installation scripts, and other support 
that makes software easier to use. (Boo! Extra work might be involved.) 

To get a handle on what different wiki engines can do, we categorize the wiki 
engines into five basic groups, each matching a particular set of requirements: 



i>* Desktop wiki engines run on your own computer and aren't accessible 
to other computers on your network or on the Internet. These can be an 
attractive way to store information for personal use. Sometimes people 
keep notes in wikis while they create content or organize information. 
Desktop wikis like TiddlyWiki, which creates an entire wiki within a Web 
page using Java, can keep track of information that is just for your own 
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personal use, such as to-do lists and appointments. It comes as a single 
HTML file that you can save to your hard drive. (There are other options 



+ I^V*»sted consumer wiki engines are made to be as easy to use as possi- 
ble. Commercial wiki providers such as Confluence Hosted (a hosted ver- 
sion of the Confluence wiki engine) and Google's JotSpot are easy to set 
up and use. So are free hosted wikis like WikiSpaces, seedwiki, PBwiki, or 
XWiki. All these wikis avoid the more gruesome installation and configu- 
ration challenges that you can encounter with some open source wikis. 

The downside is that these wikis are hosted, which may not be accept- 
able, with limits to how they can be customized and extended. If all you 
want is a basic wiki, though — which can solve a lot of problems on its 
own — a hosted consumer wiki should be fine. If you think a hosted con- 
sumer wiki is what you need, take a trip to Chapter 5. 

& Industrial-strength wiki engines are the state of the art in wiki technol- 
ogy. This category of wiki comes with features for security, integration 
with corporate computing environments, creation of complex docu- 
ments, administration, spam prevention, and customization. TWiki.org 
and MediaWiki are two of the most powerful open source industrial 
strength wikis. Socialtext and Confluence are commercial examples. 
These wikis are used at some of the largest companies in the world 
including Google, Sun, Motorola, and others. The catch is that to use 
these wikis, you must have servers to host them as well as a system 
administrator to install, configure, and administer them. 

v 0 Special-purpose wiki engines apply the idea of wikis to specific needs. 
Here are some examples: Swiki is a search-oriented wiki. DokuWiki is 
designed to create documentation. MoinMoin has some great features that 
support the publication of complex documents. TikiWiki is focused on con- 
tent management. When your need matches one of these special-purpose 
wikis, you'll feel like you're in heaven because all your needs are taken care 
of. Special-purpose wikis usually require that you have access to a server 
and know how to install, configure, and administer a wiki engine. 

t<" Development wiki engines are designed to be platforms for develop- 
ment. TWiki has an architecture that allows it to be extended with plug- 
ins and add-ons that have been used by developers to create hundreds 
of special features. Kwiki and MoinMoin were created to be easily exten- 
sible. Development wiki engines allow you to take the basic functions of 
a wiki and then add new features that do anything you want. Development 
wiki engines are for the hackers among us who have the software develop- 
ment skills and want to put them to use building perfect solutions. 

Given this list, you probably know right now which category is right for you. 
You are probably right, but don't be hasty. Keep an open mind. To choose the 
perfect wiki, you must analyze what you will be doing with your wiki. And 
who knows? You might discover that you actually need a different engine 
than you initially thought. 




reating shared wikis with TiddlyWiki.) 
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way to decide which wiki engine to use is to first determine what 
you will use your wiki for — managing a work project, collaborating to write 
documentation, or sharing information on panda bears? Also think about who 
will contribute to the creation and maintenance of the wiki — experienced 
software developers or perhaps grandma, who got her first computer last 
Mother's Day? Then evaluate how each wiki engine could help. Open a new 
word processing file or get out a pad of paper. To begin creating a require- 
ments document for your wiki, read this section and make notes about what 
your wiki is and will be. 



The skill level of the user population 

The right choice for a wiki engine depends largely on the skill levels of your 
users. For example, the wiki that Google uses (TWiki.org, an industrial-strength 
wiki) might or might not be the wiki engine for you. Google is full of brainiac 
engineers who learn new stuff pretty darned easily. Although your Cub Scout 
troop members might have bright parents, they might be a bit less adaptable 
or have less time or motivation to adapt to a new tool. Consumer wikis might 
work better for them. Here are the types of questions to help you define your 
user skill base: 



\S Are they experienced, every-day computer users, or are they beginners 
who aren't familiar with a browser? (If they can't use a browser, using a 
wiki would be a stretch.) 

If they are regular users of word processing programs, would the idea of 
wiki markup send them up a tree? Do they need WYSIWYG (What You 
See Is What You Get) editors? 

f* Can they understand camel case links? (For more on wiki markup and 
camel case linking, see Chapters 6 and 7.) 

Don't just imagine the skills of new users. Sit them down in front of the wiki 
engines that you're considering and see how they do when they create and 
edit pages. You can discover a lot in just a few minutes, such as their ability 
to figure out how to move around the wiki as well as how comfortable they 
are with browsers in general. If you don't have access to the users of your 
wiki because you're putting it out in front of the general public, find stand-ins 
for who you expect to use the site. 



The number of people rtho Witt add content 

People who create and improve content provide the heartbeat of a wiki. In most 
wikis, for every person who edits a page, tens, hundreds, or even thousands 
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of people might look at the page and use the information. The more contribu- 
tors you have, the more you need to craft the experience to their needs — and 
you should lean toward an industrial-strength wiki. 

The number of people Who 
Witt View the content 

Consider how many other people might be involved. Tens, hundreds, thou- 
sands, or even more? If a small number of people (10 to 20) are coming together 
in a casual way to work together (such as a scout troop), almost any wiki engine 
can handle that level of traffic, either as a hosted wiki or as a wiki engine run- 
ning on a small server (like a desktop personal computer). In other words, a 
consumer wiki would do fine. 

When you start reaching into the hundreds of potential wiki users, especially 
when they're all in the same organization or share the same information 
technology infrastructure, the more you enter the realm of the industrial 
strength wiki. Or if your wiki will face the public — for example, a wiki to be 
used by American Idol to create biographies of each candidate — you're 
likely going to have a ton of users. In that case, the wiki engine and servers 
you choose better be industrial strength — or scalable, as the engineers 
would say. 

There are no J.D. Power and Associates ratings for wiki scalability and qual- 
ity. However, you can answer questions about speed, reliability, and perfor- 
mance by looking at what sorts of sites use which wiki engines. Most wiki 
engines have Web pages listing sites using the engines. Most sites based on 
wikis say which wiki they use in the About section or in a Powered By link at 
the bottom of the page. MediaWiki, the wiki that runs Wikipedia, has lots of 
developers worried about making it reliable and speedy. For other wikis like 
WikiSpaces, the point is not scalability but ease of use. For more on scalabil- 
ity, see the later section, "Comparing Wiki Engines." 



The Wiki's security teVet 

Some wiki engines come with a full-blown security system so that webs and 
pages can be protected from viewing by unauthorized eyes. On the other end 
of the spectrum, some wiki engine developers look down on the whole idea of 
security as a profoundly un-wiki idea. If you have some pages that are for 
some users but not others, you need an industrial-strength wiki. Think about 
what your security needs are before you go on a second date with a wiki 
engine. 
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The u/iki's potential size 



i engines handle a modest amount of content (fewer than 500 pages) 
fell but then keel over and die when the number of pages gets too 
large (more than 5,000, for example). If your wiki will grow to tens of thou- 
sands of pages, sticking with industrial strength wiki engines makes sense. 



Whether you need automation 

A little history from Dan: When I started using my wiki, I never thought that I 
would end up automating anything. I just wanted pages that could be shared so I 
could write books. It didn't take long before I set up e-mail notifications to inform 
me when certain pages were changed. Then I set up reminders about when pro- 
jects were due. Then I started mailing notes into the wiki that were automatically 
converted to wiki pages. Then I started keeping track of interviews and research 
in a wiki-style database that allowed me to search, sort, and write reports about 
pages that represented individual interviews and research documents. 

Some people write advanced applications with wikis as a platform. If you're 
the kind of person who pushes technology to the limit to help you, consider a 
development wiki engine like TWiki or Kwiki that supports this sort of 
automation. (See Chapter 14 on structured wikis for a tour of the sort of 
tricks you can play.) Figure 10-1 shows a TWiki interview log page that was 
automatically generated from pages that were used like database records. 
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r wiki engines are made to be easily installed and never have to be 
except for creating and editing pages. Development wiki engines are 
designed to be toolkits that allow developers to go wild creating new things, 
such as full-blown applications with workflow and document management. 
Industrial-strength wikis require care and feeding of the sort mentioned in 
Chapter 11. Can you handle the technical work yourself, or do you have 
access to people who can help you? 



More from Dan: Although I did a fair amount of programming early in my 
career, I don't do much nowadays although I do heavily customize and 
extend my wikis through consultants who form an informal development 
department for me. All the people I work with are experts in Perl, TWiki, or 
both. If you want to push your wiki engine to the limit and develop custom 
applications, try to create the same sort of network for yourself. If you hang 
out with a bunch of PHP (PHP Hypertext Preprocessor) hackers, perhaps 
MediaWiki would be the best choice. There are Python wikis, Perl wikis, Java 
wikis, Ruby wikis, and all sorts of other wikis. 




Choose your wiki engine so that getting the technical help will be easy. If you 
don't have access to technical skills because you don't have them or can't 
find them, stick with a hosted consumer wiki. 



l/our Willingness to become 
a Wiki champion 

Although it's easy to dream about how a wiki can benefit an organization, bring- 
ing a wiki to life requires a lot of work. You must choose a wiki, get it running, 
seed it with content, and basically do all the things in this book related to creat- 
ing and managing a wiki. If you want to change your organization through a wiki, 
you should seriously consider whether you have the passion — and most 
importantly, the time — to become the wiki champion who carries out all the 
tasks just mentioned. Don't fret if you're too busy to do the job. Perhaps 
someone else in your organization would be delighted to take on the role of 
wiki champion, so you can work together to create a wiki. 



Comparing Wiki Engines 



If you followed the earlier parts of this chapter, you have a handful of notes 
about what features and capabilities you need in a wiki. Feel proud of yourself. 
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You just lived up to the Socrates advice to "know thy wiki self." At least we 
think that's what he said. With these basics in mind — the parameters that 

engine must fit — you can start comparing wikis to choose the best 
ur needs. 



Making the safe choice 

If you're not much of a do-it-yourselfer and you just want to make the safest 
choice, worry not. Table 10-1 lists the most obvious choices for various ways 
of using wikis. 



Table 10-1 


Safe Wiki Engine Choices for Various Uses 


Wiki Purpose 




Safe Choice 




Publishing content, creating 
content in a group, creating a 
content-focused wiki 


MediaWiki (www . mediawiki . org) 
The most popular wiki engine for content- 
focused wikis has many features for group 
collaboration and lots of documentation. 
DokuWiki (www. splitbrain . org/ 
pro j ects/dokuwiki) 
A great choice if you're creating technical 
documentation or a user manual. 


Creating advanced a 


pplications 


TWiki (http: // twiki.org) 





for collaboration and content The most advanced structured wiki with 

management many plug-ins to provide automation. 

Twiki.org also has a large, active 

developer community. 

Creating a wiki in a company Confluence from Atlassian 

(www. atlassian . com) 
Socialtext (www . socialtext . com) 
TWiki (http: // twiki.org) 
All popular choices. All three provide 
support and professional services, which 
are must-haves for many IT departments. 

Playing around All the hosted wikis mentioned in Chapter 5 

are great for playing around. 
TiddlyWiki (www. tiddlywiki . com) 
A wiki implemented in JavaScript in a 
downloadable page;the quickest wayto 
have your own wiki that you can use even 
when you are not online. 
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Exploring the WikiMatrix 



a do-it-yourselfer and you want to perform your own analysis, here's 
vice: "Know thy wiki engine." For a wiki comparison, visit WikiMatrix. 
org (www. wikimatrix . org), which was created by the German company 
CosmoCode. The WikiMatrix home page is shown in Figure 10-2. 



Figure 10-2: 
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the Wiki Choice Wizard or table. Just select them on everything Wiki. WlklMatrtx's 

create a customized the left and dick the Documentation Wlkl, 
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WikiASP 

Wiki Asp is a wiki server 
written in ASP (Active Server ! 
Pages) code for Microsoft 
Windows. It is a derivative of 
the original Aspwikl engine. It 
is probably one of the easiest 
to use and most effective wiki 
programs available for FREE. 
Code is simple and easily customizable. 



Free Wiki Software 

Installs in Minutes ■ Auto Updates Download 
Now lor Free 



A Wiki Without The Wlkl 

Finally, A Wiki For Nor.- Tec hies. Manage 
Pr&pctS A Cl 



What is Enterprise 2.07 

FrM report on Enterprise Web 2.0 Learn to 

leverage Blogs, Whs, R5S 



WikiAsp is a FREE wiki program, so easy to install. The Wiki Asp 
program code was written and is now being maintained by 
Elrey Ronald V. 



If you've ever tried to do side-by-side comparisons of software products, you 
can appreciate the great gift that WikiMatrix represents. Most of the time, get- 
ting an objective analysis of one software product compared with another is 
almost impossible. Software vendors frequently don't make accurate compar- 
isons easy. Although you won't find barriers when gathering information 
about open source projects (which most wikis are based on), reading through 
Web sites and even source code to analyze what an open source project does 
can be hugely time-consuming. 

The WikiMatrix home page 

On the WikiMatrix home page shown in Figure 10-2, you can see a set of four 
main headings, each of which can be hugely helpful in your quest to under- 
stand wikis: 

Choose: The link under the Choose heading leads you to the Wiki Choice 
Wizard that asks you a series of questions and suggests wikis that can 
meet your needs. 

]S Compare: On the far left side of the page, the Compare button allows you 
to select any number of wikis and then create a page listing side-by-side 
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comparisons of more than 40 different features that wikis have, such 
as which programming language they are based on, if they support 
I^WJ^SIWYG editing, and what database (if any) is used to store the wiki 
|\f^e files. (The Compare link in the center of the page just goes to 
Help text.) 

V Talk: The link under the Talk heading leads to the forums where you can 
discuss your wiki needs and ask questions. 

i>* Enhance: The first link under the Enhance heading leads to the page 
explaining how to add a wiki to the matrix. The second link leads to the 
Documentation Wiki of WikiMatrix, which is a storehouse of detailed 
information about many of the wikis included in the matrix. 

The WikiMatrix Wiki Choice Wizard 

A great way to start using WikiMatrix is to take a quick tour through the Wiki 
Choice Wizard to see the wikis that it suggests. This wizard asks such ques- 
tions as 

1 is* Is a page history needed? 

V Is WYSIWYG editing crucial? 

is* Do you prefer a hosted or installed solution? 

V Do you need your own domain? 
v 0 Do you need corporate branding? 

After answering these questions, you see a results page like the one shown in 
Figure 10-3. 
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Figure 10-3: 
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Thats it! 

Okay. You want a hosted offer with WYSIWYG editing and a 
page history using your own domain. 

The following 12 Wikis match your criteria: 

BrainKeeper, Centra I Desktop, ClearWiki, EditMe, Netdpia, 
PBwiki, SamePage, SeedWiki, Socialtext, StikiPad, Wetpaint and 
Wiki spaces 

— Compare them 

— Customize your choices In the Search 



Finish 

A Wiki designed 
for Business Teams 

Voted "Best of the Web" 2006 



| Risk Free Trial- Click HeTe~| 
^CentralDesktop 
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You can jump right to a comparison by clicking the Compare button on the 
results page. Or to find out more about wikis that are suggested, click the 
to see a page similar to Figure 10-4. 



Figure 10-4: 
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Welcome to WikiMatrix's very own wiki. W 

This wiki is designed with these purposes: (1) Co document the features of the various Wiki engines that are 
comparable through the WikiMatrix system; and (2) to record the evolution and features of WikiMatrix itself. 

The WikiMatrix wiki is open for everyone, so feel free to improve Its contents. 

The WikiMatrix wiki is based upon *) DokuWtki, so its Formatting Syntax rules apply. 

If you have any problems, questions, or suggestions, please discuss them in the forum. 

WikiMatrix Features 

a Wiki Comparison - what it is all about? 

■ Wiki Features - what are all those things in the comparison table? 

a Flagging - filter the comparison table 

a Register - step out of anonymity 

a Adding a new engine - enhance the Matrix 

a XML API - use the WikiMatrix data 



. wikis at WW Mum 



Click the picture to get a quick visual overview on on how the comparison tables work. 




The WikiMatrix Docs page holds explanations of the features included in the 
comparison as well as a list of all the wikis in the WikiMatrix. For some of the 
wikis, extensive documentation is available on WikiMatrix. Just because a 
wiki doesn't have documentation on WikiMatrix doesn't mean that the docu- 
mentation doesn't exist; it might exist at the home site of the wiki. 



The WikiMatrix features list 

The most valuable part of WikiMatrix could well be the WikiMatrix features 
list. Simply click the Wiki Features link in the page shown in Figure 10-4 to see 
the page shown in Figure 10-5. 

For a great education in wiki features, such as page permissions and e-mail 
notification, read through the entries in this list. They explain in varying levels 
of detail the features that are supported by most wiki engines. For example 

Text Files: Click this link to find an excellent discussion of how wikis 
support text files as well as the advantages and disadvantages of using 
them to store wiki pages. 

V Host Blocking: This entry explains how host blocking can be used as a 
last resort to stop a wiki vandal from harming a wiki. 

Content Include Feature: This entry explains how the Content Include 
feature allows one page to be all or part of another page. 
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Figure 10-5: 
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Wiki Features 



Modern Wiki engines have a huge list of features. For users new to the Wiki world it is sometimes hard to understand what a feature means and if 

she needs it. All features listed in the Wiki Comparison have their own page here in the Wiki which tries to explain this. 

The following features are already documented; 

■ ACL (Access Control Lists) 

■ Authentication Backends 

■ Author 

■ CamelCase 
« CAFTCMA 

■ Change Summary 

■ Conflict Handling 

■ Content Include Feature 

■ creole_ support 

■ Datastorage 

■ Delayed Indexing 

■ Doubleclick Editing 

■ Email Notification 
• em bedded_ flash 

■ faq_tags 

■ fi)e_ attache m en ts 

■ Free and Open Source (FOS5) 

■ Host Slocking 

■ known 

■ Last release 



After you read through the feature list, you can make much more sense of the 
WikiMatrix Compare functionality. A few hours spent traveling between the 
features list and the Compare function should help you get the idea of what 
sort of choices you have in a wiki engine. 




Keep your users in mind while you perform comparisons. You can easily get 
lost in the cool things that wikis can do and forget that the success of your 
wiki depends on getting a bunch of newcomers excited about learning to 
create and edit wiki pages. 

When comparing wiki engines, take a minute to look at the discussion areas. 
You might see a post from someone who switched from one wiki engine to 
another — and the reason why. 



Going on a Wiki Walkabout 

The categories at the beginning of this chapter and the questions about your 
requirements will help you narrow down what sort of wiki you want to use. 
And time spent at WikiMatrix prepares you for afternoons wiled away bliss- 
fully thinking about wikis. However, in order to choose the right wiki, you 
must not only think about wikis, but you must use them and see how each 
wiki engine feels. That's why you need to go on a wiki walkabout — meaning 
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that you must examine your short list of choices as closely as possible to see 
how well each wiki meets your requirements. 



e reasons why WikiMatrix exists is so that information about wikis is 
easily available rather than cloistered and hoarded. Environments where you 
can play with wikis are also easy to find, either on each wiki engine site or on 
sites built from a particular wiki engine. You can thank the world of open 
source for all this easy access and openness. In the world of commercial soft- 
ware, getting access to the same level of information is much harder. 



For someone choosing a wiki engine, the availability of wiki sandboxes — spe- 
cial areas on the sites for wiki engines that allow you to edit wiki pages — 
provide a perfect way to gain hands-on experience. Instead of having to read 
and analyze, you can play and discover what works for you. 




You're not the only one who can play with a wiki. Invite others who are inter- 
ested in your wiki to join you on your walkabout and see how they like each 
wiki engine. 



Follow along as we take you on a sample wiki walkabout for a hypothetical 
project. In this example, we are choosing a wiki to create a policy and proce- 
dure manual for a bank. The initial requirements are 

V Security: The users for this project are in a bank, which is supported by 
an IT (information technology) department that enforces heavy security 
on all computing resources. 

Editability: Users should be able to change and update the content. 

Long page modification: The first version of the manual was created 
using an open source wiki that presents wiki pages as one long page; 
experience shows that it is difficult to teach others to modify long wiki 
pages. A common wiki feature, called section editing, makes editing long 
pages much easier by allowing editing of just a portion of the page with- 
out having to edit the entire page. 

PDF creation: The wiki form of the content will serve as the means by 
which users access the document online. The policy and procedure 
manual will also be published and distributed as a PDF document. It 
would be great if the wiki engine had a feature to convert pages to PDFs 
or to export pages as plain HTML. 

u* Easy installation/IT-compliant: The solution should be easy to install 
and also acceptable to the IT department of the bank. 

With all these factors in mind, we focus on industrial-strength and special- 
purpose wikis during our walkabout. 
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walkabout will be different from ours. As you review and evaluate 
ikis, keep the following points in mind: 

Part of choosing a wiki is deciding when not to use a particular wiki. 

Choosing a wiki can be like a multiple choice test: Narrow your answer by 
ruling out the ones that really aren't going to work for you. You're left with 
fewer choices to decide between, which will be an easier decision to make. 

W Rest assured that no wiki choice is always correct. And don't be sur- 
prised if nothing seems very clear. With every wiki engine — just like 
with other types of software — some functionality will be missing, and 
you will have challenging problems to overcome. 

V Choosing a wiki engine is not irrevocable. It's not even as bad as a cell- 
phone contract. You won't be locked in to your wiki engine, and you 
don't have to pay a fine to start over with another. You gotta start some- 
where. Making a wiki engine choice and getting experience using a wiki 
is more important than agonizing over making the perfect choice. 

V You can test before making a commitment. The great thing about wikis 
is that you can try one before you commit to it. If you want to test some- 
thing like section editing, have at it. Usually, all the other features that 
you might want to use can be tested as well. 

XWiki Walkabout 

A good wiki to begin with is XWiki, which is an industrial-strength, open 
source wiki that can be used in a hosted manner and has a huge amount of 
interesting features. 

XWiki.com (www . xwiki . com) is a commercial, open source, hybrid company. 
Under this increasingly popular model, a group of people create a product as 
open source and then attempt to build a business by selling wiki development 
services and additional features. XWiki offers hosted wiki solutions for free 
and for a fee. 

At the home page of XWiki.org, shown in Figure 10-6, you can get more details 
about the features. See how XWiki stacks up for our hypothetical bank wiki: 

W Security: XWiki has a user-authentication system that allows control 
over page-access rights. 

W Editability: XWiki supports WYSIWYG editing. 
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Long page modification: XWiki doesn't support section editing, which 
allows editing of smaller sections of large pages. 



Easy installation/IT-compliant: XWiki has all the advanced plumbing to 
fit into a large corporate IT environment, such as features to use existing 
user IDs and security. 

One aspect of XWiki is a little worrisome: The product is based on Java, 
which is a language that most IT departments like; and it uses Java modules 
like Jakarta and Hibernate, which are also powerful and reliable software 
components. Although these are industrial-grade, open source components, 
installing XWiki at the bank might cause problems for the IT departments 
that are sometimes nervous about open source. The XWiki reliance on the 
MySQL open source database might also be hard to arrange at the bank. 

After playing around with XWiki, we felt that the performance was slow 
and then we really started to think that the lack of section editing was a 
showstopper. 



At the MoinMoin wiki (www . MoinMoin . WikiWikiWeb . de), you might find a 
lot to like. The site is clear, clean, and readable, and it has a feature that 
allows a page to be shut off from editing. Other features include 

Security: MoinMoin has all the security features you would need. 

f* Editability: MoinMoin features a great WYSIWYG editor. In place of the 
traditional Edit button, you can substitute an Immutable Page indicator, 
meaning that certain pages can be shut off from editing. 

V Large page modification: MoinMoin doesn't have section editing. 

t<" PDF creation: MoinMoin has many advanced publishing features for 
converting pages into complex documents. 

Easy installation/IT-compliant: Like DokuWiki, MoinMoin stores pages 
in files, so a database isn't required. MoinMoin is written in the Python 
language. Python programmers tend to charge higher rates than PHP 
programmers and can be more difficult to find. 

The MoinMoin wiki has an elegant architecture for macros and templates. 
Also, for each part of MoinMoin that is extensible, the site has a marketplace 
where extensions can be downloaded and examined. But at this point, you're 
really missing the lack of section editing. 




creation: XWiki can create PDFs from pages and has a powerful 
)lating system that controls the format of pages. 



MoinMoin Walkabout 
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Figure 10-6: 

XWiki is a 
commercial, 
open source 
wiki. 



Welcome to XWiki 



XWikl is an open source UHd written in Java and released 
under the lGPI license. 

A wiki Is a website tnat allows you to collaborate with 
others XWIkl offers all the features thai you can find in a 
typical wiki. in addlilon. XWlkl is a second MOMMM flflfl 
(a.k.a an application wiki) Ideally suited for developing collaborative web applications. 



We are still migrating content 
from the old Kwiki.org web site. 
If you're not finding what you're 
looking for here try the ohi site. 



Features 



Use simple wiki syntax to format text, create 
tables, create links, display Images, etc. 
Alternatively use a powerful WYSIWYG 
editor to edit the content of documents. 



Document Lilecvcie 

Edit. Snow, Print. Delete, Copy 

and Rename documents. 
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TU/iki Walkabout 

TWiki (http : / /twiki . org) is one of the most popular wikis used in the 
workplace. It is very extensible, with over 250 plug-ins at TWiki.org. The Web 
site lists many consultants that offer support and professional services for 
the open source wiki. TWiki has a long laundry list of features; the ones Dan 
is interested in include 

f* Security: TWiki has sophisticated access control features where you can 
define who can create, edit, and view content on a page level, web space 
level, or the whole site level. With LDAP (Lightweight Directory Access 
Protocol) integration, you can even restrict access based on LDAP groups. 

Editability: The user can choose between wiki markup editing and 
WYSIWYG editing. 

v 0 Large page modification: TWiki has good section editing, but the 
optional SectionalEditPlugin needs to be installed. 

PDF creation: TWiki has a number of extensions to export content into 
HTML and PDF. With the GenPDFAddOn, you get a PDF link on every 
page to generate a PDF file on-demand. 

u* Easy installation/IT-compliant: TWiki is relatively easy to install. It has a 
short list of required software; like DokuWiki and MoinMoin, TWiki does 
not require a database. TWiki is written in Perl. 

TWiki has many advanced features to create composite documents. Variables 
can be defined to create text with dynamic content; pages can be included 
into a master document; it is even possible to pass parameters into included 
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pages, which allows one to create reusable text fragments. A table of con- 
tents can be generated automatically, both on individual pages and across 
|ie templating system makes it easy to create a set of pages that 
limilar layout. 

TWiki would be a possible choice for this wiki project, as it is for most of Dan's 
projects, but the fact that TWiki's more advanced features are not needed for 
this project caused Dan to continue his walkabout. 
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MediaWiki Walkabout 

MediaWiki (www.mediawiki . org/wiki /MediaWiki) is one of the best pub- 
lishing wiki engines in existence. It powers Wikipedia and has a large devel- 
oper community that focuses on scalability and ease of use as well as 
creating powerful tools for editing and managing a large community of edi- 
tors, writers, and readers. MediaWiki has a lot of other great features, too: 

f" Security: MediaWiki has a good security model for public wikis, but it lacks 
fine-grained access control that's needed in a corporate environment. 

f* Editability: It offers excellent editing tools, including a WYSIWYG editor. 

Large page modification: MediaWiki has section editing. 

i>* PDF creation: MediaWiki supports PDF creation. 

Easy installation/IT-compliant: MediaWiki is well regarded and installs 
easily, but it requires the MySQL database. MediaWiki is written mostly 
in PHP and another obscure language called OCaml, which might cause 
jitters. 

MediaWiki would work in most ways, but we're nervous about asking the 
bank to install a database. 



bokuWiki Walkabout 




DokuWiki (http : / /wiki . splitbrain . org/wiki : dokuwiki) is a clean 
and stripped-down wiki with the ability to edit portions of pages. Figure 10-7 
shows the ultrabasic home page of DokuWiki. 

Don't judge an open source project by its Web site. Excellent open source 
projects sometimes have bare-bones Web sites. A great Web site is usually a 
sign of quality, but there's no guarantee. Look at DokuWiki's features: 

Security: DokuWiki doesn't offer much in terms of security. 

Editability: The text editing is not WYSIWYG but is supplemented by 
buttons that make wiki markup much easier to use. 
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f Large page modification: The DokuWiki section-editing interface is 
quite natural and easy to use. 

creation: DokuWiki doesn't support PDF creation, but its template 
era (although not advanced) — as well as the raw code that it uses — 
is simple and easy to understand. DokuWiki is written in PHP. Even if 
you're not a PHP expert, it's not too hard to figure out when you look at 
the code for the templates. You can also easily find PHP programmers. 

Easy installation/IT-compliant: DokuWiki has the ability to use an exter- 
nal user-registration database. Pages are not stored in a database. All 
its pages are stored in text files. For some purposes, this might be a 
problem — like if you want to search and sort through pages or do 
advanced application development — but this simplicity means that 
the bank might be more willing to install it because no database is 
required. 
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When we went to the DokuWiki playground to enter text, the performance 
was fast, and the user interface was easy to understand, so not much training 
would be required. The automatic TOC and the search indexing are also 
excellent features that we weren't looking for but realized might be useful. 

At the end of the walkabout, we decided to move forward with DokuWiki. We 
knew that we would have to spend some time to make DokuWiki work how we 
wanted, but the functionality it started with was sound. We also felt comfort- 
able that we would easily be able to get help making DokuWiki work how we 
wanted and that it wouldn't be too hard to adapt DokuWiki given its simplicity. 
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■ M yWsis are run by programs called wiki engines. For most of the history 
WW of wikis, getting a wiki engine running was much harder than most 
people could handle. That's why engineers had all the fun with wikis. They 
had the servers and advanced technical skills, allowing them to set up their 
own wiki engines in a snap. Today, hosted wikis (also known as wiki farms) 
allow many more people to get in the game. At a hosted wiki, a generic wiki 
engine is already set up and running on the farm. To get a hosted wiki up and 
running now takes only five or ten minutes and very little technical expertise. 

Although hosted wikis have their place, many organizations and situations 
require their own wiki engine that is under their control and not shared in 
any way. The market has responded in a variety of ways to this demand. No 
longer do you need access to your own server to get your own wiki engine 
going. There are many ways to have a wiki that you can call your own. 

Chapter 10 shows you how to select a wiki engine. This chapter helps you get 
your chosen wiki engine up and running. To give you an idea of what exactly 
is involved in installing and configuring a wiki, we tell you how to set up a 
TWiki engine, one of the most popular wiki engines. Although every engine is 
different, this chapter walks you through the basic steps of setting up pretty 
much any wiki engine that you might choose. 
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people, hosted wikis don't make sense for a variety of reasons. 
Perhaps the information on the wiki is sensitive. Or, the access to the wiki 
needs to be controlled. You might want to have the wiki tightly integrated 
with your work environment so you don't have to sign on separately to the 
wiki and keep track of an additional login account. Compliance regulations 
might forbid any sort of hosted arrangement. 

Many people get started on a hosted wiki and then at some point want to cus- 
tomize more than the hosted environment allows. Hosted environments are 
always adding features to prevent this exodus, but it happens anyway, espe- 
cially when you want to create structured wiki applications. 

Whatever your reasons, if you want to host your own wiki, you must find a 
way to get your own wiki engine up and running on a server that you control. 
Of the many ways to make this happen, we recommend the following three as 
the most viable. 



Hosting on a shared or dedicated seri/er 

If you're getting a wiki engine running on your own, the best plan is to find 
one of the many hosting providers on the Internet that sell access to shared 
or dedicated servers. One such site is www.wikihosting.net, which lists 
wiki-hosting offers. (See Figure 11-1.) 
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Shared and dedicated servers differ in the following ways: 
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ed server: A shared server allows your Web site to run on a machine 
hosts many other Web sites. You control your Web site but share the 
server space with other Web sites. If everything works well, none of the 
Web sites interfere with each other. Shared web hosting can run any- 
where from $5 to $40 per month. 

v* Dedicated server: A dedicated server is one on which your Web site runs 
on a server exclusively. This is the model that Dan prefers for his wikis, 
though it is more expensive than using a shared server. Dedicated 
servers run anywhere from $100 to $300 per month, depending on the 
services offered and size of the machine being rented. 



In either of these hosting methods, you might be able to install a wiki when 
you purchase your server. This is not usually the case, however, and you must 
find someone to help you who has the necessary skills and know-how — an 
Internet mechanic, if you will. After you find your mechanic, you grant the 
helper access to the server so that he or she can install your wiki. 

For many small businesses or organizations that want to use advanced wikis, 
dedicated hosting can be a good choice. In larger organizations, though, this 
approach might not work because users must go outside the approved envi- 
ronment and must also remember a new username and password. 



Hosting inside your organization 

A second wiki-hosting choice is to use a computer inside your organization. 
Two reasons why wikis have flourished inside engineering organizations is 
that they have plenty of servers and that engineers know how to be their own 
Internet mechanics. 

The rest of us aren't so lucky. If you try to set up a server on your own, you 
might run afoul of organizational policy. If you ask for a server to be set up, 
you might run into a lengthy bureaucratic process, or you might be forced to 
find financing in some budget. This is often harder than you'd like. Although 
complaining about red tape is easy, that crimson cord is usually in place to 
make sure that any server is properly supported, backed up, and maintained. 



Contracting all-in-one hosting 
and consulting 

The demand for wikis has become so great that the market has developed all 
sorts of services. Some dedicated and shared hosting providers give you a 
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server with a wiki already installed. MediaWiki is probably the most common 
wiki engine used in this way. After you get started with such a wiki, though, 
perform maintenance and make updates to it on your own. 



you don't have access to your own Internet mechanic to handle advanced 
wiki configuration, consider looking for a hosting solution that provides pro- 
fessional wiki consulting as well. XWiki.com (www.xwiki . com) is a hosted 
wiki that truly offers all-in-one service. In addition to basic various hosted 
and self-run wiki services, you can hire XWiki.com consultants to help you 
get everything going and afterward on an as-needed basis. 

Getting help requires money, of course, but XWiki (see Figure 11-2) has an 
impressive list of happy clients on its site. Fees to set up a wiki can run from 
several hundred dollars to several thousand dollars, based on how much cus- 
tomization you are seeking, whether there is existing content to convert, and 
the number of servers you will need to run your wiki. 



Figure 11-2: 
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Finding an Internet Mechanic 

Most people are comfortable with flipping a compact disc into a computer and 
then clicking through the steps to install a word processor program or a photo 
database. Wikis don't run on your desktop computer, though. For a wiki 
engine to run properly, it must be installed on a Web server, which requires 
some knowledge of how Web servers work. Expertise is also required to set up 
the storehouse of wiki pages, configure account login settings for users, and 
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so on. If installing a program on your desktop is like filling up the gas tank of 
your car, installing a wiki engine is like changing your own oil and spark plugs 
jtting the ignition timing. 



The technical challenges of running a wiki engine mean that you must make a 
choice: 



Take the time to master all the different aspects of Web hosting and 
system administration to get a wiki engine running. 

Find someone else to do it for you. 

For most wiki owners, including Dan, the right answer is to find someone to 
help. You likely want someone with the following skills: 

V System administration: Your Internet mechanic should know how to set 
up and run a server as well as be knowledgeable about system and net- 
work administration. 

Internet administration: The Internet mechanic should be knowledge- 
able about Web servers and the Internet in general. 

Programming and database experience: Programming skills are usually 
beneficial, as is having experience managing databases. 

V Security experience: An understanding of Internet security and the 
changing threat-landscape is very important. 

V Backup and recovery expertise: Wikis are often work repositories. As a 
result, they must be carefully backed up by someone who doesn't take 
chances. Losing your hard drive is nothing compared with the pain that 
you could feel when your entire wiki is lost or can be recovered only 
from month-old backups. 

If you're serious about getting a wiki going, sit down and make a list of all of 
the people you know who are programmers and system administrators and 
anyone else who might be qualified. Web sites such as Guru.com 
(www. guru . com) or RentACoder (www. rentacoder . com) help you find 
freelance Internet mechanics. Although setting up a wiki does require special 
knowledge, an expert Internet mechanic can help you get a wiki engine run- 
ning in just two to three hours. 

All you really need to tell your Internet mechanic is 

i>* Which wiki engine you want to set up 
Where he can download it from 



Then, grant your mechanic access to the administrative account for the 
server that you're going to use for your wiki. 
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It helps if you get an Internet mechanic who is familiar with the wiki software 
you want to have installed. Some open source wikis list consultants on their 
On TWiki.org, you can find this list at 




http : / /twiki . org/cgi-bin/view/ Codev/ConsultantsForHire 

If you're setting up a wiki inside a company, your information technology (IT) 
department is the place to start. In some companies, getting help can be as 
easy as getting someone to throw a wiki on a development server so you can 
play with it. In other companies, it might mean a lengthy process of getting 
the wiki approved. 

Here's another good resource for information about what it takes to be an 
Internet mechanic for wikis: 

http: / /twiki .org/ cgi-bin/view/TWiki/AdminSkillsAssumptions 

This page at TWiki.org — the wiki shown in most of the examples in this 
chapter — lists the desirable attributes for a wiki Internet mechanic, as 
shown in Figure 1 1-3. 
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fix the documentation If you find errors or incomplete contenl. Put questions and suggestions concerning the 
documentation or this topic in the co mments section below . Use the Support web lor problems you are having using 
TWlkl 



Administrator Skills Assumptions 



Ntw : if you aren't already fairly well-skilled in Linux; Unix Windows. Apache, and so on, consider using 
TWlkl Codev.TWIklVMDebianStabie - this can be installed on Windows or Linux, and makes II possible to get a working 
TWiki system within 5 minutes [after a (airly big download), ready to use from your browser. This is ideal for personal use or 
evaluations - if you decide to go for production use then these / yj n i . n ■'■ k 1 1 ) ASMfl WtflUB a PP iv to some degree, but you are 
starting from a working system. 

If you need to Install TWiki you'll need to either have or learn the following skills [even with 

TWlkl Codev.TWIMVMDebiaiiStable . youH need these for upgrades I. For each of these, the requirement is either 

pre-existing knowledge.' skill, or the willingness to spend significant time (i.e. from hours to days) learning them: 

• Operating system administration: Ability to use Unix/Linux command line tools (or equivalent Windows tools), 
including ability to move/ copy /delete files, change permissions, view web server log files, set environment variables, 
use a text editor, etc. 

• Web server administration: Ability to do basic setup, e.g. ability to edit config files or use GUI configuration tools 
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requirements for getting a wiki engine running are getting access to a 
server and (unless you have the expertise yourself) finding a qualified Internet 
mechanic to help you. At this point, we assume that you've done both these 
things. If you haven't, please refer to the earlier sections of this chapter. The 
following sections help you prepare for and configure a wiki engine. 



Meeting system requirements 



After you have a server and a mechanic lined up, the next step is to make sure 
that your server has everything you need. For TWiki (one of the more well- 
documented engines available), this is as simple as going to the Web page at 



http: / /twiki .org/ cgi-bin/view/TWiki /TWiki SystemRequirements 













This page (as shown in Figure 1 1-4) lists the detailed system requirements for 
the TWiki engine. 



TWiki System Requirements 



Server ana client requirements 

Low client ana server base requirements are core features that keep TWiki widely deployable particularly across a range of browser platforms and 
i Many P^ijii'.b and o.p.'rif' iu-iuu: :-- exist which enhance and expand TWiki's capabilities: they may have additional require 



Server Requirements 



TWiki is written in Perl S, uses a number of shell commands, and requires RGS <Re\ 



HI. a GNU Free Software package TWiki ii 



developed in a basic LinuxyApache environment. It also works with Microsoft Windows, and should have no problem on any other platform that meets 
the requirements. 



Figure 11-4: 
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Perl 5.D05_03or higher (5 8.4 or higher is recommended) 

RCS 5.7 or higher [including GNU <ii:t) 

Optional. TWiki includes a pure perl implementation of RCS that can be used insiead (although it's slower) 

GNU o^!t GNU an t 2.7 or higher is required when not using the all-Perl RcsLite 

Install on PATH if not included with RCS (check version with dm -v) 

Must be the version used by RCS, to avoid problems with binary attachments - RCS may have hard-coded path to d 
GNU pitch For upgrades only GNU f.itc: is required when using the i i ■. i- : '.v < <\ . scnpt 

GNU fjTup. egrep Modify command line parameters in configure if you use non-GNU grep programs 



CrorW scheduler 



■ Unix: cron 

■ Windows i 



Apache is well supported; see TWiki. TWiki.lnstallinoTWikiffOtlTefWebServere. for other servers 
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In addition to hardware requirements for the server, TWiki also requires that 
certain software be installed. This is very typical of wiki engines and many 
;en source applications. Some of the open source programs that 
quires are 

f Perl: This is the programming language used to write TWiki. TWiki came 
to life because Peter Thoeny, inspired by another wiki, started writing a 
new wiki in the Perl language. To make TWiki work, a version of the Perl 
language must be installed on your server. Version 4 of TWiki requires 
Perl Version 5.6.1 or higher. (The or higher means that newer versions 
[those with a higher version number] will also work.) 

CPAN Modules: CPAN, the Comprehensive Perl Archive Network, is a 
repository of thousands of these modules. CPAN modules are programs 
written in Perl that perform special functions. These modules are the 
software equivalent of an inventory of special-purpose, reusable parts. 
The developers of TWiki used these modules to save time, but it's cru- 
cial that all the required modules are installed; otherwise, TWiki won't 
work. The TWiki requirements page also lists optional CPAN modules 
that could be useful for special purposes. 

V Other software: TWiki uses RCS (a version control system), GNU utilities 
for determining the differences between files and applying changes to 
the software, grep utilities for searching through text files, and the cron 
scheduling system for running programs repeatedly at predetermined 
times. (If you don't know terms like grep and cron, you might think that 
they're rude noises. Actually, they are Linux things.) 

Besides required software, there is often also a recommended list of software. 
For TWiki, the recommended software for the operating system and Web 
server are 

Linux: This is the famous, open source operating system created by 
Linus Torvalds. Linux is a Unix-like operating system that runs on per- 
sonal computers (PCs) and servers. 

Linux isn't mentioned as a requirement on the TWiki system require- 
ments page. The page says that TWiki is developed in a Linux/Apache 
environment and that it will also work in Microsoft Windows. In practice, 
however, unless you are an expert and want to fight a lot of technical 
battles, Linux is recommended. The installation will work smoothly on 
Linux, will be pretty easy in other flavors of Unix (such as Mac OS X), 
and will be more difficult on Microsoft Windows. Nevertheless, TWiki 
has been installed on many different operating systems, all the way from 
PDAs to mainframes. 
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Apache: This is an open source Web server that accepts requests for 
pages from your browser and then sends back pages. TWiki communi- 
s through the Web server. 



i has its own environment. This environment is the combination of the 
Web server, language, language modules, and utilities that TWiki needs to 
work. Every other open source wiki (and most of them are open source) has 
its own collection of requirements. Choosing a wiki that your Internet 
mechanic understands means choosing one that uses a set of components 
your mechanic already knows so that he or she won't have to start from 
scratch when learning about the wiki. 



After you and your Internet mechanic create a system that meets all these 
requirements, the next step is to visit the TWiki Installation Guide at 



http: //twiki .org/cgi-bin/view/TWiki/TWikilnstallationGuide 



The Installation Guide — as shown in Figure 1 1-5 — takes you through the step- 
by-step process of installing TWiki. Because TWiki is one of the most mature 
wiki engines, the installation and configuration process is highly automated 
and contains a lot of fill-in-the-blanks procedures. Other, more bare-bones 
wikis, such as DokuWiki and Kwiki, require more fiddling with complicated set- 
tings contained in parameter files. 



TWiki Installation Guide 

Installation instructions lor tne TWkl t. 0 production releasa 

TWiki should be tine win any web server and OS thai meel the ivitfm ifciiuucmsnls . The Following installation instructions are written for expenenced 
system administrators: please review the AdminSkilisASi-u.Ti i i.iic.ri* before you install TWiki if you need help ask a question in the TWiki 5uot.on web or 
on TWiktCooev TWikiiRi. (irc.freenode net channel *twiki| 

Q Hint rwiki twiki iisr jliirn'j Wiki on TWiki org has supplemenlal documentation thai help you Install TWiki on different platforms environment and 
web hosting sites. 



Basic Installation 



Figure 11-5: 
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Guide at 
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Download the TWiki distribution from r ■ n j ■ ■• ■ v:\\ i ■.-.i , , . ,■; i - 1 . . i 

Make a directory For the installation and unpack the distribution in it. 

Make sure the user that runs CGI scripts on your system can read and write all Flies in the distribution 
Detailed instructions on file permissions are beyond the scope of this guide, but In general: 

° Dunng installation and configuration, the CGI user needs to be able to read and write everything in the distribution. 

■-- Once Installation and configuration is complete, the CGI user needs write access to everything under the data and pub directories and to 
lib/Looatsite.irf g. Everything else should be read-only 

° Everybody else should be denied access to everything, always 
Make sure Perl 5 and the Perl CGI library are installed on your system. 

The default location of Perl Is tuttr/bioi'tmex. If if* somewhere else, change the path to Pert in the first line of each script In the lafcUtUbJuj 
directory - 

D Some systems require a special extension on pel scripts (e.g. .ogi or ,pL|. If necessary, rename all flies in twiKi/ain (I.e. rename view to 
viuw.pl etc). If you do this, make sure you set the scnpts'.iiiu option in rait [Step 6| 

Create the file /twilci/biii/LoealLlb.ctg. 

There is a template [or this file in /twiXt/tin'Ltwaliib.c(g.tjtt. 

The file must contain a setting for ftwDtiiLcpatn, which must point to the absolute file path of your > wini/nt-e.g. /hemiE/nttpd/thiJiA/iiJi 
Q If you need to install additional CPAN modules, but cant update the main Peri installation files on the server, you can set scffiijeASE to point [o 
your personal CPAN install. Don! forget that the webserver user has to be able to read those flies as well. 
Configure the webserver so you can execute the tun/kronlirrur'-' script from your browser 
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r what your skill or experience level, when you install TWiki or any 
i engine, you will have questions. TWiki.org has many ways to find 
answers, including 

v 0 Installation Guide: Read the Installation Guide carefully before you start 
installing so that you understand the configuration process. When you 
start installing, though, you might have questions that are not answered 
in the guide. The guide refers to other parts of the detailed and extensive 
TWiki documentation. To view the documentation guide, visit http : / / 
twiki . org and click the Documentation link in the left navigation bar. 

f* Support Web: This is the second help stop for most users. Here, you can 
look through other questions that people have asked and also add your 
own questions. At TWiki.org, the Support Web is found at 

http : / /twiki . org/cgi-bin/view/Support/WebHome 

IRC: You can often find wiki help using IRC (Internet Relay Chat), which 
is an open source precursor to the instant messaging (IM) programs that 
are so popular. IRC is an early version of IM that is used quite a bit in 
open source communities. IRC allows you to join the equivalent of a chat 
room and then ask questions to experts who might be hanging out in the 
chat room, waiting to help. Instructions for downloading the TWiki IRC 
software are on the TWiki Support Web. 

Mailing lists: Usually, open source projects have one electronic mailing 
list for the developers and another list for the users. These mailing lists 
can be used to keep track of developments and to see the kinds of ques- 
tions being asked and answered. You, of course, can ask your own ques- 
tions on these mailing lists. At TWiki.org, the mailing lists are primarily 
for development and system administrators. The lists are listed at 

http : / /twiki . org/cgi-bin/view/Codev/TWikiMailingLists 

Observe certain ethics and protocols when asking questions in open source 
communities. For example, if you spend but a few minutes trying to figure 
something out and then start asking basic questions that are already 
answered in documentation, don't be surprised if the responses to your 
inquiries are a little frosty. However, if you precede your questions with a 
description of all the information you found to help solve your problem and 
detailed explanations that show you did your homework, you'll likely get a 
rapid and helpful response. 



If you're installing another open source wiki, you'll probably find support 
options similar to the ones listed here, especially for projects that have been 
around a few years. For commercial wikis, you'll find some of the same sup- 
port sources that we just mentioned as well as others, such as telephone- or 
IM-based support. 
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ur wiki server environment is ready, your Internet mechanic is all 
p, and you know how to get questions answered, let the installation 
process begin. 

The first step is to download the wiki engine software from the Web site. At 
TWiki.org (like most open source projects), you'll find a link to download the 
binaries — the distribution — of the software, prominently placed on the 
home page. Figure 1 1-6 shows the TWiki.org home page with the Download 
link at the top-right. 



Figure 11-6: 
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TWiki™ - an Enterprise Collaboration Platform 



What is TWiki? 



Welcome to TWiki, a flexible, powerful, and easy to use enterprise 
collaboration platform and knowledge management system. It is a Struct ! 



Download TWiki 4.0 



rwiki Hoipase 4.0-2 



wlfc typically used to run a project development space, a document 
management system, a knowledge base, or any other groupware tool, on an 
intranet or on the internet. Weh content can be created collaboratively by 
using just a browser. Users without programming skills can create web 
applications. Developers can extend the functionality of TWiki with Plugins. 
^ F^l Tell * Fnen.j 

"We use TWiki internally to manage documentation and project planning for 
our products. " said Eric Batdeschwieler, Director of Software Development of 

Yahoo! "Our development team includes hundreds of people in various locations all over the world, so web 
collaboration is VERY important to us. TWiki has changed the way we run meetings, plan releases, document our 
product and generally communicate with each other, we're great fans of your work'." 

new Compare TWiki, Confluence arid XWiki , and see TWtki details on the v\ikiMa cm web site. 

What does it look like? 

TWiki looks and feels like a normal Intranet or Internet web site. However it also has a Edit link at the bottom of 
every topic (web page), everybody can change a topic or add content by just using a browser. 

TWiki is hosted and developed here at the TWiki.org web site. You can surf and add/change content a to get an 
idea of how TWiki works. Start surfing at the WebHc-me topic, or learn about the platform in the Welcome Guest . 



The download page has a lot of information about the current release, such 
as what new features have been added and other ways in which TWiki might 
have changed. To download the software, follow these steps: 

1. Click the TWiki Release link. 

The download page for the current release version of TWiki appears. 

2. Click either the Zip or the Tgz link in the box marked Download 
TWiki, as shown in Figure 1 1-7. (Read about these formats in the 
nearby sidebar, "ZIP and TGZ.") 
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Figure 11-7: 

Download 
TWikiinZIP 
or TGZ 
format. 
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TWiki Production Release 4.0.2 

Download the latest stable TWiki Release from this page. 

TWiki is a flexible, powerful, and easy to use enterprise 
collaboration platform, It is a Structured Wiki which can be used to 
run a project development space, a document management 
system, a knowledge base, or any other groupware toot, on an 
intranet or on the internet. 

Release 4.0 is the first major release in a year, adding simplicity in 
installation, integrated secunty features, and much more. 

Major New Features 

• WYSIWYG editor (beta) 

• Revamped PatternSkin with a modem look and lots of 
customization options 

• Much simpler install and configuration 

• Integrated session support 

• Webserver-independent login/logout 

• Security sandbox blocks all possible routes for remote 
command execution on the server 

• New editing model with conflict resolution allows freer 
collaboraoon, without fear of overwnttng other people's 
changes 

• Multilingual UI: Chinese, Danish, Dutch, French, German, 
Portuguese, Spanish 

• E-ma.i ■ • ■- i, ■ ■'r:,ii. r. r"-.-'' 1 ' .9 amm-n.] 



3l Har 2006 ■ 07:03 - PeterThoeny topic end 
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TWiki is open source software. 
The Perl CGI source code default 
templates and documentation are 
available fo> *ee and can be ledisnbuted 
under the terms of GPL (Gnu General 
Public License i. Tne identical zip and 
.tqz packages can oe used on all 
platforms: an installation guide >s 
included in the package supplemental 
documentation reman; [Maticrm specific 
ins true bote. 

TWiki 4.0.2: 

' Release notes 

• System requirements 



• Upgrade guide 

• 'Jc, 3 3'Jinq ana V 



3. Go refill your coffee cup while the download commences. 

4. When the download is complete, double-click on the ZIP or the TGZ 
file to unzip it. 

After the download is complete and you unzipped the files, you're ready 
to connect to the wiki's Web server and begin the actual installation 
process. 



Connecting to the Web server 

Downloading and unpacking the binaries for the wiki engine is pretty easy. 
The next step — connecting to the Web server that will host the wiki — is a 
lot trickier. After that's done, though, the rest of the TWiki installation is 
pretty much downhill. By connecting, we mean that you tell the Web server 
that when a request for a URL comes in the View program in TWiki, binaries 
should run and display the pages requested by the URL. A typical URL might 
look like this: 

www.mysite . com/ twiki /bin/view 

Here's where you start putting a lot of things together. The view program is a 
Perl 5 program that uses all the CPAN modules, the utilities, and the RCS 
repository to perform the functions of the TWiki engine. So far, so good. 



Chapter 11: Getting Your Wiki Engine Up and Running 




ZIP and TGZ 



ZIP and TGZ file formats are two ways how used on Linux and other Unix operating sys- 
TWiki binaries are compressed. ZIP is popular terns. Your Internet mechanic will know which 
on Windows PCs. TGZ is a form of compression one to use. 



However, telling you exactly how to configure your Web server correctly so 
that it connects the URL to the TWiki binary is beyond the scope of this 
book. The TWiki documentation doesn't even explain it because it can vary in 
so many ways, depending on what sort of Web server you use and what ver- 
sion you use. This step is where you really need your Internet mechanic. 



What should happen is something like this: 



1. When the Internet mechanic gets to the connecting step, he or she will 
stroke his beard (or curl her hair) and mumble in a knowing way. 

2. The mechanic follows the instructions in the Basic Installation section 
of the TWiki Installation Guide. 

3. After performing the basic installation, the Internet mechanic goes 
to the http . conf file on the server and makes a few changes to 
connect the wiki's URL to the right directory in the file system. 

4. The mechanic enters a URL into a browser. 

The TWiki engine spits out the configure page described in the next 
section. 



This is an exciting moment. Often, the process doesn't work the first time you 
do it (for example, because permissions in the file system are set wrong or 
because the Web server needed to be restarted), but eventually it does. After 
you see the configure page delivered from TWiki, you're almost done. 



Running the configure script 

The configure script is the basic script that controls configuration of your 
wiki. In most Linux-style installations, you have to run this script at the com- 
mand line. Because TWiki is more evolved, you can configure your wiki by 
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using a browser. (We still call this section "Running the configure script" so 
that you can impress any geeky friends you might have by saying, "And then I 
onfigure script.") To configure your wiki, enter this URL in a Web 



www . my site. com/ twiki /bin/ configure 

The page that appears lists the current configuration settings for your wiki, 
as shown in Figure 11-8. Use this page to finish the configuration and installa- 
tion process. 

The TWiki configure page sets a high standard for ease of use that is rare in 
open source software. With other wiki engines, you might find yourself edit- 
ing parameter files or changing variables in programming language files. This 
is how it starts out for most open source software; after a while, though, 
someone takes on the task of making configuration easier. The TWiki config- 
ure page represents just such an effort. 
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TWiki 

Configuration 



Use this page to set the configuration options for TWiki. Fill in the settings, and then press 'Next'. 



Figure 11-8: 

Use the 
TWiki 
configure 
page to 
finish the 
installation 
process. 



Q If you are installing TWiki for the first time 

If you just want to get up and running, the only section you need to worry about below is General path settings . You can 
always come back and configure other settings later. 



• If your TWiki site is already working, continue to PiV'-.vr.o to t!» 'T wiki Reference Manual . 

o You will now need to consider how you are going to manage authentication and access control. See the reference 
manual sections on authentication and access control , and the Security Setup section below. 

• If you are on an odd platform there are a lot of topics on TWiki.org describing how to configure TWiki for dr--.- ■. 
platforms . 

• If you get stuck there is a lot of support available on TwikilRC (irc.freenode.net, channel ^twiki) and at TWtki: Support . 

Explanation of color codes: 

• Settings marked like this are required (they must have a value). 

• Any errors in your configuration will be highlighted. 

• Warnings are non-fatal, but are often a good indicator that something that is wrong. 



Environment variables (read only) 



CGI Setup (read only) j ■■■.amings 



General path settings 
Operating system 
Secunty setup 



Anti-spam measures 
Log files 
Localisation 
Store settings 
Mail and Proxies 



Miscellaneous settings 
Plugms 

Total: 2 '■■<a ri-ii ngs 

Nexl 
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To configure your wiki, review each section of the configure page and adjust 
settings as needed. The sections are 



I^CTfceral Path Settings: These variables tell TWiki where all the wiki's 
moving parts are located. The settings here tell TWiki the external URL — 
for example, www . mysi te . com/ twiki — for accessing TWiki from a Web 
browser, the directory in which scripts are stored, and the locations of 
other important files. 

Operating System: This section contains settings that tell TWiki under 
which operating system it is running. This should rarely have to be 



Security Setup: Here you set how sessions are managed, what security 
mechanisms are used, and how passwords are handled. This section is a 
good one to discuss in detail with your Internet mechanic to make sure 
that your system is secure. The sort of issues that arise in these settings 
include 

• LDAP integration if TWiki is using existing usernames 



LDAP is the Lightweight Directory Access Protocol. What it means 



• How internal usernames are managed 

• How usernames are mapped to the TWiki usernames 

t<" Anti-Spam Measures: This section controls anti-spam settings on your 
wiki and rarely needs to be changed. 

i>* Log Files: Another seldom changed section, this specifies the location of 
wiki log files. The log files are where TWiki keeps track of what happens 
with the wiki, such as registering users or accessing, saving, renaming, 
or deleting wiki pages. 

Localisation: Modify this section if languages other than English are sup- 
ported by your TWiki engine. 

Store Settings: This section lets you choose the kind of repository in 
which your wiki pages will be stored. RCS (a version control system) is 
the typical choice although other options, such as using the file system 
or a database, are possible. 

V Mail and Proxies: TWiki has an excellent integration with mail. Alerts of 
various kinds can be sent when pages change or when project manage- 
ment deadline entries expire. 




changed. 




to you is not entering usernames twice. 
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i>* Miscellaneous Settings: This section controls a general mishmash of 
TWiki settings, such as the default names for various pages and the 
th of time that pages remain locked for editing before they expire. 




ins: These settings list which plug-ins are installed and enabled. 
Plug-ins are extensions to TWiki that provide support for calendars, 
spreadsheets, editable tables, and other such items inside TWiki pages. 



After making changes to the configuration settings, click Next and then save 
your changes using the triple-top-secret password that your Internet 
mechanic set for you. You are ready to start making wiki pages and letting the 
magic happen. 
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In This Chapter 

Reorganizing and updating your wiki's content 
Rolling back unwanted changes 
Standardizing the wiki with templates 
Building a wiki community 
Scheduling wiki housekeeping tasks 



Congratulations! If you're reading this chapter, you probably already have 
a successful wiki. Like a weekend gardener going pro, or a home cook 
applying to gourmet school, you're ready to start thinking about managing 
your pet project in ways that go against — but actually work with — the 
loosey-goosey way you've been doing things thus far. You're ready to bring 
that nasty business term management to the organic beauty of your wiki. This 
doesn't mean that you've sold out to The Man or that you're no longer an 
indie wiki-creator. It simply means that your wiki has grown from a simple 
page to a complex ecosystem of competing interests and multifaceted con- 
cepts. And that's good news, right? 

Mostly. The bad news is that problems can arise because, like any project, 
wikis tend to take on a life of their own as they grow. New people add content 
willy-nilly. And their contributions, albeit valuable, are filling up corners of 
the wiki you never expected to become populated. Old users resent the new 
users and vice versa. You might have multiple users who just plain disagree 
and are changing pages back and forth like a ping-pong ball. Other conflicts 
might pop up that you never expected. 

Here's more good news: You can fix these hiccups by stepping in as the wiki 
manager — tactfully removing and reorganizing content and interposing in 
edit wars with a diplomatic flair — and lead the community to create a 
process for resolving disputes. This chapter shows you how to strike the nec- 
essary balance to ensure that your wiki remains a manicured haven of organi- 
zation and collaboration and doesn't become an unkempt garden. 
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Wiki Maintenance: Pruning, Training, 
DropR0&k£tt0 Changes 

A wiki is like a garden. It must be seeded, tended, and maintained over 
months and years. Eventually the wiki grows and overflows its original, 
stated boundaries. It is led in different directions, changing as it mutates and 
grows. It's time to step in, grab some pruning shears, and get to work to keep 
the wiki garden from becoming overgrown. 

An overgrown wiki is almost useless. Wikis use the Internet's HTML protocol 
to its best advantage, creating a linked set of "pages" or "cards" that are orga- 
nized in a coherent and useful manner. But what if things get out of hand? In 
the worst case, an overgrown wiki means you can't find what you need. You 
don't know what is on the wiki and what isn't. The taxonomy might break 
down, leaving you with 1,000 pages linked from one section's home page. (See 
Chapter 8 for more on creating logical wiki taxonomies.) The following sec- 
tions show you how to cut back the mess and train your fellow wiki-teers to 
keep things clear. 

Before we get started, here's an overview of the kinds of tasks that you, as a 
wiki manager, will do and train others to do: 

V Decide what goes where and what should just plain go. You'll reorga- 
nize, delete, break long pages into multiple pages, and just generally 
help create an optimal structure. 

i>* Train others to do likewise. When wiki-teers ask you to do XYZ on the 

wiki, teach them how to do it themselves. 

Evaluate changes. Are the changes coming in valid contributions (or 
even semivalid), or are they the work of a spammer or vandal? You have 
to keep an eye out for this, and most wiki engines let you receive a sum- 
mary of the changes via e-mail or an RSS (really simple syndication) 
feed. Changes that just plain shouldn't be there must be rolled back. 

f" Refactor the wiki, adding structure as necessary. Reorganizing can lead 
to adding some structure, using templates for example. 

V Do all those routine tasks that wikis require. In this chapter, we lay it 
all out in terms of daily, weekly, monthly, and yearly tasks, from daily 
backups to team meetings to evaluating and celebrating the wiki on its 
birthday. 
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Deciding What to cut and What to keep 



^iwnpS-tant goal of wiki management is deciding what to remove and what 
TOTceeprAlthough your wiki team might value everything it created, the differ- 
ence between a usable wiki and a mess is sometimes unnecessary or poorly 
organized content. Often, fixing the problem is merely a matter of finding the 
right home for a few misplaced pages. 

Another problem is wikis that might look like empty flower beds, waiting for 
content. Deciding what goes into these beds is one facet of the wiki man- 
ager's job. Encourage your team members to be bold, asking them to fill in 
the sparse spots and prune the dense spots. By encouraging your team to 
help in the pruning process, you ensure that their delicate sensibilities aren't 
insulted by overindulgent page removal. 

The deletion of data also depends on your office or community data retention 
policy. Even if no data retention policy exists governing your wiki, backups 
and version control systems that allow you to roll back to a previous version 
are still important. (See the section, "Rolling back changes," later in this 
chapter.) Here are two ways to handle deleted or modified data: 

Change markups: Change markups are special HTML styles that show 
changes to pages. You can use the <s> HTML tag (which strikes-through 
text) to show deleted content, and adds tiny "change" tags to modified 
or added text that users can roll over to view changes. Chapter 13 
describes the change-tracking features offered by WikiSpaces. 

Prune: Unwanted content should be pruned from your wiki on a regular 
basis. When deciding what to prune, use this checklist: 

1. Check with the author. 

If a page looks aged, does the author know? Can the author tell you 
more about it? More importantly, can the author do something about 
it? For example, the Confluence wiki engine lists the author and the 
last editor at the top of the page. TWiki lists the last editor, but you'll 
have to look through the history to find the original author. 

2. Check the date. 

Is the page out of data compared with the rest of the content? Is it 
still active? Is it still being visited? Archive or repurpose the page if 
you don't expect visitors. Check with the author first to see 
whether the page is ready to slip into wiki obscurity. 
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Check the content. 

Has the topic been covered elsewhere, making this page redundant 
and a candidate for deletion? Is it simply an administrative page 
created to maintain a template? (If so, keep it in a housekeeping 
section of the wiki, if you must keep it at all.) 

Check the links. 

Is this page a dead end? How can your users find the page? Does it 
come off a main page, or is it orphaned somewhere in the taxon- 
omy? What other pages should this page link to? 

Check the word count. 

How long is this page? An overly long page suggests that it might 
be better broken into smaller sub-pages. If it's too short, could you 
add it to another topic rather than leave it as a standalone page? 



Training your troops 

A good wiki needs good people. A wiki without contributors who write con- 
tent is just a hard disk. Your wiki also needs editors — also known as garden- 
ers — to make corrections. Your initial passion and efforts are for naught if 
your merry band of wiki-teers gives up during the extensive management 
stage. That's where the roles of manager and wiki champion become crucial. 

Training your crack team of wiki-teers is important both at the initial stages 
of the wiki as well as during regular intervals in the wiki's life cycle. Wiki 
training usually happens on the job and as needed; you probably won't con- 
duct formal training courses. Instead, you should copy the sort of approach 
taken by Wikipedia, which has a community area where the roles and policies 
are clearly explained, as you can see later in this chapter. 

Your training will have to address the fact that people take on new roles as 
they get more and more involved with a wiki. Read about the wiki life cycle 
that we mention in Chapter 1. As your wiki grows, create a page that 
describes what each role does: 

V Contributors (or writers) as well as editors (or gardeners) need to know 
whether any style should be followed when creating new pages or whether 
policies exist as to what sort of content is appropriate. 

V Managers need access to perform special functions as well as access to 
descriptions of the maintenance tasks that should be performed. 

Champions need a copy of this book and any reminders distilled from it 
to help make the wiki succeed. 
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e mysterious flame of community wikis 



i of Queen Loana, a book by 
cult favorite and erudite scholar Umberto Eco's 
book, is considered one of the densest — and 
richest — novels ever to grace the page. There 
are thousands of literary and cultural references 
throughout, and it would take an army of grad 
students to unpack them. As a result, it has taken 
on a reputation as a scholarly curiosity. 

Luckily, there are wikis. A group of Eco fans got 
together to write about the book and bring to 
light all the references and allusions. The result 
is a chapter-by-chapter wiki (as shown in the 
figure here), full of cross-references, outside 
links, and scholarship as diligent as Eco's. 

The way that this wiki grew is a lesson in wiki 
gardening. At first, a wiki page was created on 
one chapter, and then it was corrected and 



embellished until it was pretty much complete. 
Nothing much would happen until someone 
expanded the wiki to cover a new set of pages. 
The expansions would then get corrected and 
fixed by the community. The lesson is that the 
gardener might need to take the lead and create 
new flower beds so that the community can do 
the work of weeding them and filling them out. 

If your wiki becomes stale, attemptto seed new 
content and add new kinds of pages. Writing 
about music? Add pages for each song on an 
album and flesh out those pages with cross- 
links and obsessively cataloged information. 
Keep things fresh. Expand from your original 
mission and add applicable information. Build 
another Wikipedia or even improve Wikipedia 
by adding your own hard-fought information. 
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the third man - The Third Man British film from 1949 directed by Carol Reed and featuring Orson Welles 
among others Filmed in postwar Vienna the plot follows Holly Martins who comes to Vienna in search of his 
old friend Harry Lime Harry famously justifies his wickedness thus 
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Wikis are usually self-organizing. A small group of people acts as a manage- 
ment committee, but these people rarely tell each other what to do. The 
jocumentation on most wikis is not a law to be enforced but is, 
^guideline that shows how someone else approached the task. As 
time goes on, these guidelines might become well established and seem like 
laws — but they don't start out that way. 
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Wikipedia has excellent models for such training content, as shown in Figure 
12-1. This and other pages can be found at 

en .wikipedia . org/wiki /Wikipedia :How_to_edit_a_page 

en .wikipedia . org/wiki/Wikipedia :Manual_of_Style 

en. wikipedia . org/wiki/Wikipedia :Guide_to_layout 



Figure 12-1: 

Basic 
instructions 
are an 
important 
part of any 
wiki. 
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Wikipedia:How to edit a page 

From Wikipedia the tree encyclopedia 



See also W'k.ssd-a. 'niroducdcw. H'rfnperta. Tutorial Helo Editing, and Help Starting a new page 
Wikipedia is a Wiki which means that anyone can easily edit any unprotected page and save those 
changes immediately to that page After your first edit you will be a Wikipedia editor! Good luck 
with your first edit 
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Introduction 

Editing most Wikipedia pages is not very difficult at all Simply click on the "edit this page" tab at the top of a 
Wikipedia page (or on a section-edit link) This will bnng you to a new page with a text box containing the editable 
text of the original page If you just want to experiment please do so in the sandbox not here You should write a 
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Many wikis that use MediaWiki (the wiki engine on which Wikipedia is based) 
link to these pages as a way to provide training resources. After your wiki 
gains steam, though, your community will probably need its own pages to 
express local policies and habits. In addition to posting help pages, some 
other good training measures include the following: 
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u 0 Conduct meetings during the wiki's growth and maintenance phases. 

Meetings offer a sense of ownership and responsibility to the members. 




a wiki roundtable to review content, spending a few hours going 
ugh documents and assessing their values. 

Publish a monthly wiki newsletter. Mention your pruning efforts in the 
newsletter, thereby encouraging others to proactively prune as well. 

V Compare your wiki with other successful wikis, such as Wikipedia. 
Point out differences to your wiki's members. Visit http : / /en . 
Wikipedia . org/wiki /Wikipedia to read about Wikipedia's history 
and see how it compares with your own. 

v 0 Treat the wiki as a project, not just a one-off team effort. This develops 
a sense of buy-in and purpose. 



The training should help people to train others not only in basic wiki skills, 
such as text formatting and creating links, but also in the wiki mindset and 
the values of wikis. Your trainees should become evangelists for putting wikis 
to work where they will succeed. 



Rotting back changes 

A good wiki tracks page versions so that you can easily roll back unwanted 
changes. This is one of the most important features of a wiki because it 
allows you to safely encourage users to be bold. A roll-back feature makes it 
easy to undo boldness when that boldness is ill advised. To roll back changes 
on your wiki, follow these basic steps: 

1. Determine whether changes need to be rolled back. 

In most wikis, someone involved in running the wiki goes on a regular 
change patrol to examine recent changes and see whether they make 
sense. 

The Recent Changes feature of most wikis, as explained in Chapter 2, is the 
best way to run a change patrol. When you click the Recent Changes link, 
you see all the pages that have been changed. You can then go to each 
page and use the versioning feature to see exactly what was changed. 

2. Click the History tab or link on a page that you want to roll back. 

Versioning makes rolling back changes pretty easy, and each wiki engine 
handles versioning a bit differently. This chapter uses WikiSpaces as an 
example, but most other wiki engines work pretty much the same way. 
When you click that the History tab, you see a page listing all of the ver- 
sions of the page, as shown in Figure 12-2. 
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Figure 12-2: 

The history 
page of 
WikiSpaces 
shows a list 
of versions. 
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3. Click the link for the most recent version and see what has been 
changed. 

The page that appears shows the changes made to that page compared 
with the most recent prior version. Figure 12-3 shows how the differ- 
ences are highlighted. Additions are shown in light green. Deletions are 
shown in light red. Some wiki engines show the old and new versions 
side by side. 
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4. To roll back the changes, click the Revert to This Version link at the 
top of the page. 



page reverts to the earlier version. 



Avoiding uriki spam 



Spamdexing is another name for commercially oriented vandalism. 
Spamdexers put advertisements or promotional links in wiki content 
designed to promote their products or to increase their page rank so they 
appear higher on search engines. Rolling back spam changes is the most 
basic way to combat spam, but there is often a long-term battle between the 
spammers and the spammees with constantly changing tactics. If your site 
starts to get spammed on a regular basis, read through these sites for the 
most current ways of combating spamdexing. Then, consult your Internet 
mechanic for help in implementing them: 

en . wikipedia . org /wiki /Link_spam: Antispam advice straight from 
the granddaddy of wikis 

i>* www. structuredwikis . com/peter_2 006-08-06 .html: Peter 
Thoeny's survey of wiki-related spam resources 



Refactorinq your uriki 

Refactoring means restructuring. This term is often applied to computer code, 
but it also applies to design: taking something that's awkward and turning it 
into something elegant; or changing it to make it work better. 

Wikis are filled with content, much of which is text. You can refactor text in 
the ways that we describe earlier in this chapter: pruning, breaking large 
pages into smaller ones, and changing the structure. 

More uniform structuring calls for a different type of refactoring that might 
involve code, as we describe in Chapter 14. Here is a brief introduction to 
using templates to structure wiki content. 

Reinventing the wheel every time you create a new page makes no sense. 
Certain pages in your wiki start to take on similar forms and eventually 
become standardized in a template. Many wikis also have a way to put the 
same content on many different pages without creating new versions of that 
content. Keeping on top of when new templates or new reusable content 
must be created is an important task in managing a wiki. 
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How Wikipedia fixes itself 



ferful resource, but it's also 
a target for vandals. Too, the temptation to add 
two (or three) cents worth of gibberish is often 
too great to resist. Great and small topics are 
often vandalized, leading to messy pages and 
real problems. 

Despite this, Wikipedia is self healing because 
of its large community. First, a thriving band of 
people are on change patrol at Wikipedia. 
When a user — or moderator — discovers a 



problematic page, the administrators can auto- 
matically roll back a page to its original state 
very quickly. If one user makes lots of nasty 
changes, all changes made by a single user can 
be rolled back in one command, and the vandal- 
ism is taken care of. In other words, Wikipedia is 
great at playing defense. Wikipedia's change 
patrol is so active that many times, ridiculous 
changes are rolled back in a few minutes. 



In the world of word processing, a template is a shell document that you fill 
in. In the world of MediaWiki — the wiki engine that runs Wikipedia — tem- 
plate often means a link to some standard text that might be included in 
many different pages. See Chapters 6 and 8 for more on using MediaWiki-style 
templates. For the purposes of this chapter, a template is an empty page with 
a structure that you can fill in. 

Templates simplify tasks and solve problems in many ways, including 

V Templates can simply be instructions for how to create standard pages. 
For example, the Baseball Reference Bullpen page shown in Figure 12-4 
lists the basic sections that should be included on each page. 

V Templates are indispensable when deciding what goes where in your 
wiki taxonomy. By creating a set of pages — and templates — that users 
can expect to see, you ensure that they follow the proper formats and do 
self pruning. 

f* Templates help standardize information. When you're looking to collect 
certain information from every member of the Lost in Space fan club — 
such as age, favorite character, and the like — providing a template 
through which users can enter this information helps you get what you're 
looking for. Such standardization won't happen on its own, leaving you to 
wonder whether certain readers (like you) prefer the Robot to Dr. Smith. 

Chapter 14 provides details about creating your own wiki templates. With a 
little simple code, you can create templates that guide users to enter similar 
information. For example, a list of contact information is much easier to com- 
pile automatically if everyone enters the same information in the Contact 
form. (Chapter 14 also covers wiki magic like this.) 
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Figure 12-4: 

Sometimes 
a template 
is simply a 
set of 
instructions 
for creating 
pages. 
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1 1 Amateur career info when available 

2i High school attended (in the demographics section) 

3| Minor league info 

4| Post -baseball experience 

5) A picture 

Si Sources 

— Miscna 11 12 31 August 2006 (EOF) 
Repnnted by — David — 10 20 CST 6 Feb 2007 

Other Info to be included 

Mosl articles are obviously incomplete presently Basic information that Could be included in a players page would be something hka. 

Basic information and picture 

Biography 

Notable Achievements 

Records 

Quotes 

Quoies by this person 
Quotes about this person 
Bibliography 
Related Sites 



Other Points 



[edtfj 

If you want to make pages look pood, li s worth learning about fancy Wiki formatting We don't have a lot about it here but trie Wikipedia help !* 



Grinding through Routine 
Administrative Tasks 

If you ever have to write a wiki management job description, please leave out 
the florid, community-oriented prose we use in this chapter. Write something 
like, "Informational manager needed to create and maintain an asynchronous 
content management system based around the wiki framework." Then, list a 
few requirements: 

i>* An ability to herd cats 

An understanding of library sciences and templating 
i>* A love of language in all its forms 

Then, when your new hire comes in, hand over the following lists of daily, 
weekly, monthly, and yearly tasks that are key to wiki maintenance. 
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:s should be performed to ensure the integrity of the wiki. You won't 
o them all every day By paying attention to these tasks each day 
though, you can see what needs to be done. (After all, if someone wants to 
use your wiki, you don't want to make him wait for a week to get access!) 
Daily tasks should include 

t<" Managing users: Fix user registrations, reset passwords, rename user 
accounts, lock user accounts, and remove user accounts. You might 
need your Internet mechanic to train you on how to do this or set up an 
interface through which you can do it. This depends both on the wiki 
engine and on your level of expertise in system administration. 

f Rolling back problematic modifications: Because anyone can change a 
wiki, sometimes people add inappropriate or whacky content. You have 
to watch your wiki. 

Backing up the wiki or making sure that it's backed up: Backups are 
covered in Chapter 13. 



Weekty tasks 

Some tasks don't need to be done every day. They can be performed more 
infrequently, but they shouldn't be ignored. Here are some tasks to attend to 
weekly to keep your wiki humming: 

v 0 Manage groups. Create groups, add/remove users to/from groups, and 
set read/write access restrictions based on groups. 

Suggest new ways of using the wiki. Send out helpful hints such as: 
"Did you know you can automate the meeting minutes? Here's how." Or, 
"You can use a spreadsheet formula to calculate the total. Do this. . . ." 

is* Look for old pages that might have become obsolete. Send obsolete 
pages to the contributor for repair. 

V Ensure that front page links are active and usable. Do this by visiting 
the home page of each department and following the taxonomy down 
one level. 



Monthly tasks 

Once per month, take a step back and really assess how your wiki is doing. 
Monthly wiki tasks include the following: 
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V Assess the current business, organizational, or community structure. 

Has it changed? Do you need to change the wiki to reflect these 



!ck the taxonomy. Have your users created new pages that don't fit 



into existing categories? Do new categories need to be created? 

Look for new forms of standardized information. Is the same sort of 
information showing up on many pages? Should that information be 
standardized. Should templates to encourage use of this new standard- 
ized information be added to the main template repository? 

u» Look for pages with heavy use. The pages that are edited the most are 
probably extremely useful. But just like high-traffic areas in your home, 
you have to clean them out and organize them so they continue to be 
useful and pleasant. They may grow too long and become overgrown 
with irrelevant information that makes a useful page less useful. Edit and 
trim them as necessary, perhaps breaking one page into several. 

t<" Look for old pages for deletion or repurposing. Check with the page's 
creator to see whether it's still useful information that just needs to be 
updated. If not, delete or repurpose it. 

«>* Check for new wikis and create them as needed. Is a department's wiki 
getting too complex? They might be ready for their own web, and you 
can create it for them. Better yet, train someone in that department to 
watch over the new web and help you out. 

Produce a wiki e-mail newsletter. Send interesting links to your team 
and encourage them to use the wiki more next month. By keeping the 
wiki on their radar, you ensure its growth and development. 



Some tasks need to occur only once yearly. These often involve meetings, 
assessing the big picture, and having face-time with your team. Do not be 
afraid of the team! They are here to help. Annual tasks to conduct with your 
team include the following: 

Decide whether the wiki is working. How is the team using the wiki? 
Should resources be spent next year to maintain it? Is it valuable? 
Decide what makes it valuable and worth the resources (in both time 
and money) that you're spending on it. 

Create a list of wiki best practices. Have each team member describe his 
experiences with the wiki and distill those insights into a best practices 
document. Is someone in accounting using the wiki to plan lunch? 
Suggest that the marketing team try the same. Is the wiki becoming too 
cumbersome? Figure out how other departments prevented this problem. 




\lear(y tasks 
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V Reassess the current crop of wiki management systems. Could your 
roll backs and backups be made easier with new hardware or software? 

t does your wiki need to thrive? Are there new plug-ins that provide 
tionality you'd like to try out? (See Chapter 14 for more about plug- 
ins; chat up some wiki administrators to find out about the latest hard- 
ware and software.) 

V Reassert the wiki's importance through memos, interpretive dance, or 
by buying a Happy Birthday, Wiki cake. Celebrate the wiki, recognize 
those who have contributed to the wiki, and show others you're excited 
about it. Your excitement might just rub off on more members of the team. 



Chapter 13 

Protecting Your Wiki 



In This Chapter 

Understanding threats to your wiki 
Running your own change patrol 
Controlling editing access 
Preparing for and recovering from disaster 

••••••••••••••••••••••••••••••••••••••••••••••••a 

7 he whole idea of protecting a wiki seems like a contradiction. Aren't wikis 
supposed to be open and free? Isn't the idea of wikis to avoid putting up 
barriers while encouraging everyone to share and participate? 

To be sure, wikis are all about openness and sharing, but you must face facts. 
If your wiki is out in the open, always remember that the Internet has some 
bad neighborhoods. A small number of people with malice in their hearts will 
vandalize anything that they can for no good reason. Malice isn't the only 
danger, though. Even if your wiki is within the boundaries of a trusted com- 
munity, people make mistakes. In their zeal to share and contribute, vast por- 
tions of your wiki could be erased by a naive and well-meaning beginner — or 
even a seasoned user who is in a hurry or having a bad day. 

The solution to wiki security is not to erect barriers and undo the ease of use 
and free expression that make wikis what they are. More than a decade of 
experience has evolved into a prudent approach to wiki protection as a three- 
fold defense: 

f Be able to roll back damage. Many wikis come with a reversion 

capability — that is, you can revert a page to an earlier version of itself. 
Being able to keep an eye on what edits are made (through a change- 
tracking feature) will help in this department. 

W Selectively erect barriers that protect certain types of content. If 

you're not cool with letting all people come to your wiki and edit to their 
heart's content, you can restrict editing privileges to those who have 
member accounts. You can even restrict viewing rights in some cases. 

Back up the wiki's content. The best offense is a good defense, and 
there's no better defense than making regular backups of your wiki. 
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This chapter reviews the mechanisms and practices that have become stan- 
dard ways to protect your wiki while keeping it free and open. 
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Evaluating Threats to \lour Wiki 



Don't get the wrong impression: Most of the time, wikis are used properly. 
Wikis are seeded with content. People learn how to use them. More content is 
created. Goals are achieved. Hooray for your wiki! 

The more successful your wiki becomes, though — whether you're inside a 
company with a project management wiki or out on the high seas of the 
Internet with a content-focused wiki about a TV show — the more you should 
be ready to deal with the threats described in the following sections. 



Vandalism 

Wikipedia is probably the most vandalized wiki on the planet. Any regular vis- 
itor to the site will occasionally notice erroneously deleted pages or stupid 
changes that are meant to be clever. Spammers put advertising messages in 
wiki pages. People seeking to improve their ranking in search engines put 
links from wiki pages to their sites. 

As part of the process of running Wikipedia, volunteers regularly staff the 
Change Patrol. They use the ability of wikis to report recent changes as a way 
to create to-do lists. People on the Change Patrol look over changes made to 
pages and roll back those that are just plain vandalism. The community of 
people who maintains Wikipedia has all sorts of fancy tools that can roll back 
all the changes made by a user in one command. This makes it easy to 
quickly undo changes made by some jerk. 




If your wiki is open to collaboration, it is open to vandalism. There is really 
no recourse but to have your own version of the Change Patrol and to get 
good at using the tools described in this chapter to manage your wiki. 



Passion 

The Los Angeles Times created an experimental wiki called Wikitorials. This 
experiment quickly showed that wikis don't resolve conflicts that exist in the 
real world. Instead, wikis generally just reflect those conflicts. If you have a 
wiki page that brings out the passion people have about an issue, that page 
or set of pages might have to be managed differently. Figure 13-1 shows just a 
few of the warnings that appear on the discussion section of the Wikipedia 
page about abortion. 
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[show] 



The warnings in Figure 13-1 attempt to handle the passion that people have 
on the subject by explaining to potential contributors that content on the dis- 
cussion section of the page should be about how to improve the page — not 
about debating the issue of abortion. 

Wikipedia also limits editing of the article section of the abortion page, as 
shown in Figure 13-2. If you are unregistered or newly registered, you can't 
edit the page. Instead, you are referred to the discussion page — the one with 
all the warnings shown in Figure 13-1. You can request that these restrictions 
be waived by clicking the Request Unprotection link (in the box with the pad- 
lock) shown in Figure 13-2. 

These restrictions stop people from going ballistic on the page in the heat of 
the moment. If you want to edit the abortion page, be prepared to back up 
your request to edit the page with a detailed rationale for why the edits are 
both unbiased and needed. This policy (of protecting certain pages from 
edits) was born of much experience and seems to work. This tactic might 
work for controversial pages on your site as well. 
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From Wikipedia. the free encclapedia 
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An abortion is the removal or expulsion of an embryo or fetus from the uterus resulting in or caused by its 
death This can occur spontaneously as a miscamage or be artificially induced by chemical surgical or other 
means Commonly 'abortion refers to an induced procedure at any point during pregnancy medically it is 
defined as miscarriage or induced termination before twenty weeks gestation which is considered nonviable 
Throughout hisiory abortion has been induced by various methods The moral and legal aspects of abortion 
are subject to intense debate in many parts of the world 
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Enthusiasm 

Wiki culture recommends bold action. Don't be afraid to change things. Do it. 
Get involved. Understandably, the price of this attitude is that sometimes 
people get carried away and make changes all over the place, even in places 
where their contribution is not terribly valuable. Enthusiasm can also lead 
people to make changes that don't take into account the style of the wiki or its 
editorial practices. Damage done through enthusiasm is not as black-and-white 
as vandalism, but you will know it when you see it. Usually, finding a bunch of 
problematic changes from a user who wants to get involved can be an opportu- 
nity for training, eventually creating a strong player for the community. 



Mistakes 

Because wikis work through browsers, which are not quite as reliable or easy 
to use as most word processors, pages are frequently marred by editing mis- 
takes. Sometimes just a few slip-ups on the keyboard can cause a whole page 
of content to disappear. Or perhaps your cat jumps on your keyboard and 
makes a statement while you have a page in editing mode. These mistakes 
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System failure 



can make you quite grateful for the version control feature of wikis that lets 
you go back to and restore previous versions. (We explain how to do this 
e chapter.) 



Because wiki engines are pretty simple programs, most of the time, they work 
fine just as intended. However, software does fail, servers crash, and disk 
drives go bad. Like every other sort of computer-based resource, wikis must 
be protected from system failure based on the importance of the wiki. At the 
very minimum, the wiki must be backed up. In addition to this, you might 
want to have some other server waiting in the wings to restore the data so 
that you can keep working while your original wiki server is repaired. 



Running \lour Ou)n Chanqe Patrol 

So, it happened. You went to your wiki and were shocked to find that some- 
one added a huge picture of a kitten wearing a sunbonnet on your front page 
The Help section was changed to a recipe for buttermilk pancakes. All over 
the site, you found links to sites about crochet patterns. Clearly, something 
weird is afoot. What are you going to do? 

Clearly, your wiki needs a Change Patrol. This patrol might be a cadre of 
trusted and willing wiki members, or it might be a task that you have to do 
yourself. Whoever staffs your Change Patrol, the following sections describe 
what they (or you) need to do. We use a wikispaces.com wiki (http : / / 
wikisf ordummies . wikispaces . com) to show the general steps involved, 
but most other wikis work in a similar manner. 



Rotting back changes 

The first order of business in dealing with unwanted changes is to get this 
junk off of your wiki. The great news is that almost every wiki engine has an 
easy way to go back to previous versions of pages. 

As we wrote Wikis For Dummies, we added some links to the page shown in 
Figure 13-3 to see how they would be formatted. The figure shows two entries 
at the bottom of the page that were put in to see how wikispaces.com han- 
dled WikiWord links and links to external sites. Now it's time for those links to 
come out. 
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Across the top of the page in Figure 13-3 are several tabs: 



«* Page: Shows the content of the page 

Discussion: Shows a page for making comments about the page 

History: Shows the version history of the page 
V Notify Me: Helps you keep track of changes on the page 

Click the History tab to open the page shown in Figure 13-4. The History page 
shows a list of all the versions of the page, descending by date. At the top of the 
list is the most recent version of the page, which is the version displayed on the 
Page tab. As you go down the list, you find older and older versions of the 
pages, each of which was the starting point for the version higher on the list. 

To compare any two versions, click the Select button under Compare next to 
one version, and then click Compare next to another version. The page in 
Figure 13-5 appears, highlighting changes in one of two ways: 

i>* Green text: Green text was inserted in the newer version. 
Red text: Red text was deleted in the newer version. 
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Text that isn't highlighted is part of both the newer and older versions. If 
you're investigating un-highlighted text, click the History tab again and com- 
pare two older versions until you find the version in which the offending text 
was added. To revert to a specific version, follow these steps: 

1. Click the History tab to return to the History page; refer to Figure 13-4. 

2. Click the date of the version to which you want to revert. 
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3. When you see a screen like the one shown in Figure 13-6, click the 
Revert to This Version link in the Actions section near the top of the 
en. 



'e: The Revert to This Version link doesn't appear at the top of the 
screen when using the Compare feature. 

4. (Optional) In the confirmation screen shown in Figure 13-7, add a 
descriptive comment, if desired. 

You might say who reverted the page and why If you leave the Comment 
box empty, the History page still displays the date and time of the ver- 
sion to which you reverted. 

5. Click the Revert button. 

The earlier version becomes the current version of the page. Check out 
the page's History tab to see that your revert action is noted in the com- 
ments, as shown in Figure 13-8. Even if it seems like a lot of steps to 
revert to an earlier page version, reverting takes only a minute or so. 
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Figure 13-7: 
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Some wiki engines don't have a Revert to This Version feature. In those wikis, 
you have to go to the version you want to restore, select and copy the text of 
the page, edit the current version, and replace the current text by pasting in 
the text from the version to be restored. 



Tracking recent changes 

Knowing how to roll back changes is the first basic skill in running a Change 
Patrol. The second is being efficient at checking changes to the wiki. Two 
mechanisms offered by most wikis make change review quite easy: 

Recent Changes page: Like the wikispaces.com examples shown here, 
most wikis have a Recent Changes link in the left-hand navigation, as 
shown in Figure 13-9. Click that link to see a list of all recent changes to 
the wiki, as shown in Figure 13-9. 

The Recent Changes page is the to-do list for the Change Patrol. How 
often you check it depends on the wiki's activity level. Once weekly 
might be good enough for some wikis; others might need a daily check. 
For the busiest wikis, the Change Patrol works continuously so that van- 
dalism and mistakes are removed minutes after they are made. 
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V E-mail Notifications: Most wikis support automatic e-mail notification of 
changes to pages, and this is another good friend of the Change Patrol. 



feature allows you to sign up and be notified by e-mail when some- 
makes a change to a page. Click the Notify Me tab on any page to see 
the page shown in Figure 13-10. 



Clickthis link to see recent changes. 
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Figure 13-10: 
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The notifications page allows you to sign up to monitor a page. If you 
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click the Monitor This Page button, an e-mail will be sent to you every 
someone changes the page. You can also sign up for RSS (really 
le syndication) feeds, which are streams of updates that can be 
accessed through programs (RSS readers). 



wikispaces.com also allows you to sign up to be notified when any page on 
the site is changed, a feature that is common for other wikis. This feature is 
especially handy to the Change Patrols on lower-traffic wikis. 



Controlling Editing Access 

Another strategy for protecting your wiki is to limit the number of people 
who are allowed to edit pages. Although this strategy seemingly contradicts 
some of the general principles of wikis, it actually makes sense in many 
cases. As we show earlier in this chapter, Wikipedia uses this strategy for 
some of its most controversial pages. 

Most wiki engines offer some way to control access. Some wiki engines, such 
as wikispaces.com, control access at the level of the wiki. A wiki can either be 
edited by anyone or only by those who have been invited and have their own 
accounts on the wiki. Other wikis, such as TWiki.org, MediaWiki, JotSpot, and 
EditMe.com, have more finely grained control. 

To see how access control works at wikispaces.com, click the Manage Space 
link under Actions in the left-side navigation area. Then click Members and 
Permissions to see a page like the one shown in Figure 13-11. At the top of the 
page, wikispaces.com lets you choose one of three modes: 

Public: Anyone can view or edit any page. 

j*" Protected: Only those invited to have a member account can edit pages, 
but anyone can view pages. 

\S Private: This setting restricts viewing and editing to those who are mem- 
bers of the space. At wikispaces.com, this feature is available only by 
paying a subscription fee. 

The bottom part of the page shown in Figure 13-11 lists member accounts 
and also includes a tool to invite new members to sign up for the wiki. Simply 
enter an e-mail address and then click Add Member to invite a new member 
to your wiki. 



Part III: Promoting, Managing, and Improving Your Wiki 




Figure 13-11: 

Most wikis 
allow you to 
control 
member- 
ships and 
permissions. 



i Windows Imernei Explorer 
Edit View Favorites Tools Help 



ysisfordurnmies » permissions 



- 0 ' 8 - - ■> Tools t 



fib wikisfordummies 

Members and Permissions 



rtwoolsemn | ~ M Account Help Sign Out f 



Actions 

Recenf Changes 
£ Manage Space 
Search I A 

Navigation 

Wikis For Dummies 
Web 

WfW Markup Test 



Space Permissions 



Viewing 
Editing 

Members 

Member 

U. noahr 
— d gabnel 



Protected 



Space members 



Member Since 

May 1 2006 2 07 pm 
May 3 2006 8 0B pm 
Jan 14 2007 11 02 am 



space members 
space members 



Member Type 

Organizer 

Member 

Member 



Pending Membership Requi 
Member 



Invite a New Member 
Username or Email 



No pending requests 



Invitation History 

Email 

. . '• .: ■ - . ■ 



Invited By 

cclsemn 



Action 

lemg/e 
remove make organize 
remove mafe organize, 



Date 

May 3 200G 5 10 pm 



Some wikis offer more advanced access control methods. These often include 



j> Grouping users and then assigning permissions by group 

Grouping pages and assigning groups of users permissions to create, 
read, update, or delete the pages 




Other advanced mechanisms for controlling access include blocking individ- 
ual users from making changes or stopping specific IP addresses from making 
changes or viewing the wiki. These more advanced mechanisms might 
require getting a hand from your Internet mechanic. Effectively using the 
mechanisms of access control means that you have less to do on your 
Change Patrol. 



Preparing for Disaster 

One of the things that people don't realize when they set up a wiki is that 
they have gone into the business of data center operations. Even if you're 
using a hosted wiki, you still need to take responsibility for making sure that 
you're protected if something bad happens, and access to your wiki is cut off. 
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Backing up yow Wiki 



the biggest sense of comfort you can get when managing your wiki is 
that you have a complete backup of all the pages on your wiki. Many 
hosted wikis make this extremely easy wikispaces.com has one of the best 
systems. On the left side of a wikispaces.com page, click the Manage Spaces 
link (under Actions) to open the page shown in Figure 13-12. This page has 
four buttons dedicated to backups: 



Backup Space: Windows .zip: This compresses all the wiki markup text 
for each page into a Windows ZIP archive. 

Backup Space: Unix .tgz: This compresses all the wiki markup text for 
each page into a Unix TGZ archive. 

V Export Space as HTML: Windows .zip: This creates an HTML version of 
your space and compresses it in a Windows ZIP compressed archive. 

V Export Space as HTML: Unix .tgz: This creates an HTML version of your 
space and compresses it in a Unix TGZ compressed archive. 



If you use these options, you can save the resulting file wherever you want. 
It's best to keep two copies: one on your local computer and one on remov- 
able media in case of hard drive failure. To restore your wiki from the markup 
text form of the backup, you have to re-create the pages one at a time and 
then copy and paste the markup text into each page. The HTML backup pre- 
serves the content and makes it possible to view the pages on a Web server 
or on your personal computer, but it is harder to re-create your wiki from 
them. Some commercial wikis (such as Confluence) provide more sophisti- 
cated support for restoring your wiki. 

This sort of backup is a quick way to capture almost all the information 
stored in your wiki. Some things might be missing from these backups (such 
as discussion threads and version histories), but saving the core content is a 
great start on a full backup. 

Of course, if you host your own wiki engine, you'll need to have someone in 
charge of making backups. Proficiency in creating systematic and complete 
backups is one very important qualification for an Internet mechanic, as 
described in Chapter 11. 
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Figure 13-12: 

Back up 
your wiki. 



■ ■.!■■ IS' ! I I , . .I-, ,... ■■■■ 



View Favorites Tools Help 



ktsfordummies * about 



wikisfordummies 

Manage Space: wikisfordummies 



Recent Canoes 
ft Manage Space 
Search !a 

Navigation 

Witos For Dummies 
Web 

WIW Markup Test 



About 

Created 

Organizers 

Members: 
License 

Space Contents 



May 1 2006 by C£ dvioodsemn 
d/.codsemn 
Ll gacnel IT noahi 

" i :.VI 7 '." -'I ■!-. I' - : Hi:. "■ !■ ■ r i : ■ 



List and Upload Fil; 
Usage Statistics 
Import a Blcci Entr\ 
Manage Templates 
Backup Space 



| Windows zip j| Unit tgz 



Export Space as HTML 1 Windows zip |[ Unix tgz 



Space Settings 

Name Descnption and License 

Lock and Feel 

l.l:.-|-.|-.T.i '-. 3|-j r-'T.r.i^biTns 

Suhscn ptiop 

Delete this Space 

Space Promotion 

Invite People 
Scace Badoes 




Finding a neut home for your Wiki 

When a wiki becomes important to you, the thought of living without it is a 
horror. If your business or organization relies on a wiki as part of its everyday 
work, plan for how you would restore your wiki to operation if some cata- 
strophic event destroyed the facility currently hosting the wiki. This could 
take the form of working out the details to move your wiki to another hosting 
provider or having some other backup server available. In any case, make 
sure that you have a plan for moving your wiki. 
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In This Chapter 

Understanding structured wikis 

Adding a search function to your wiki 

Using variables, templates, and forms to create applications 

Enhancing your wiki pages with plug-ins 



■ My hen you sit down to explore wikis, you likely don't want to delve into 
ww complex variables, search terms, and forms. You want to make a cool 
wiki for you and your office mates, get a big promotion for being proactive, 
and retire on the beach in Maui, forever branded in corporate history as "the 
guy/gal who made us wiki-tastic." Right? Right. 

But now you face the prospect of building something more with your wiki. 
Will you stand on that precipice, elated and excited at the possibilities? Or 
will you shy away and read a different book on, say, cooking or gardening? 
You, it seems, are the decider. 

So you make the leap and decide to add those advanced features that every- 
one has been asking for to your wiki. Good. We begin by talking about struc- 
tured wikis. Structured wikis originated in the brain of Peter Thoeny, the 
co-author of this book. Peter's vision was that by using simple components to 
add structure to wiki pages, and then adding plug-ins and basic programming 
mechanisms, wikis could be transformed into simple applications. Structured 
wikis are almost too complex for this book, but this chapter provides a good 
foundation. We start by showing you the basic concepts behind structured 
wikis, and then we show you how to make structured wikis perform specific 
tasks such as searching, taking input from forms, and enhancing your wiki 
with plug-ins. You're so close to doing some cool wiki things that you can 
probably taste it. If not, try licking this book. Go ahead, we'll wait. 
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Note: Our examples throughout this chapter use TWiki, which is a structured 
Wiki application that offers many cool features. Another example of a struc- 
|ri is JotSpot, but that engine is currently closed to outside users 
lit was purchased by Google. TWiki is available for download and 
testing at http : / /twiki . org. Downloading and installing TWiki is covered 
in Chapter 11. You can safely test most of the examples described here using 
the TWiki sandbox at 



http : / / twiki . org/ cgi -bin/view/ Sandbox/WebHome 



Retfiertinq Structured Wiki Basics 

Structured wikis are a hybrid of two different concepts: wikis and databases. A 
wiki is like a whiteboard — an open slate waiting for information. A database 
is a structured system for organizing data. If a wiki is like a hippie, a database 
is a square. As we all know, hippies rarely hang with squares. However, wikis 
and databases can work together with very little effort. In this section, we not 
only introduce you to the wild world of databases, but also discuss the 
important decision you face about whether you need structure in your wiki 
or not. We also talk about how you can easily include variables as well as 
functions in your wiki. This might sound technical, but don't worry — we 
take a step by step (not to mention fun) approach you can follow along with. 

To structure or not: That is the question 

How much structure should you add to content? It depends. Typically, you 
want to start simple and add structure only as needed. The organic and free- 
form nature of wikis is the essence of effective collaboration. That is, it's 
better to start wiki pages without giving too much thought to structure. 
Watch how the teams are using the wiki. If you discover a usage pattern 
where things are done repetitively in a similar way, it's time to create a wiki 
application that structures the content. Forms-based wiki applications with 
queries and reports help automate the daily workflow of the teams. 

Consider this example. A call center has a simple wiki page with a status 
board listing who is on-call at what time. This could be in the form of a bul- 
leted list or a table. While you're maintaining the status board, look for a 
usage pattern. There is a fixed list of support engineers and a fixed list of 
time slots. You can now build a simple application that automates the task of 
changing the status board: You can pick a person and time by simply clicking 
a button instead of typing a new name and time. Discovering patterns and 
adding structure is typically done a little at a time. You recognize a pattern, 
and you create a structure that makes a task or process easier for wiki users. 
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You then improve on that structure based on feedback from users, repeating 
those steps until you (and the users) are happy with the way it works. Figure 
s the final iteration of a status board. When you edit the table, you 
ists to select a new time and person. This example uses the 
EditTablePlugin, described later in this chapter. 



Figure 14-1: 

Edit the 
status board 
table to pick 
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person and 
time. 
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Using Wiki Variables 



Before you can do much with structured wikis, you need to understand how 
variables work. A variable is an item that can assume any given value or set 
of values. Take, for example, the oath that starts out like this: 













"I, {STATE YOUR 


NAME) , dc 


solemnl 


/ swear ..." 




( state YOUR name) is a variable because it will be replaced with an actual 



name; what that name is depends on who is taking the oath. 

Wiki variables are used in dynamic portions of a page that allow you to create 
tables of contents, insert the time and date, and keep track of pages with 
ease. Wiki variables can also insert little graphics into your workspace. The 
syntax for wiki variables is %variable%. (Note that variables are enclosed 
between percent signs.) This is the same syntax used in PHP and many 
scripting languages. To see how variables work in wiki markup, open a wiki 
page for editing (see Chapter 6 for more on editing wiki markup) and enter 
the following: 



+ Fun Times 




%U% %BR% 




%N% %BR% 




Q-va 9- T2T3 9- 
■OAt) "o DJa'O 




* Set FUNTIMES 


= Yes, Absolutely! 


Are we having fun 


on %DATE%? %BR% 


%FUNTIMES% 
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Save this markup on your page and view the result, as shown in Figure 14-2. 
The following describes what is happening: 



i, %N%, and %x%: These variables show the Updated, New, and Alert 
icons, respectively. These are predefined variables in TWiki that refer to 
specific graphic files. The graphic files can be changed, if you wish. 

%br%: This variable generates the HTML break (<br />) tag, which 
inserts a manual line break. 

V * Set FUNTIMES = Yes, Absolutely !: This line creates a new vari- 
able. We set a variable called FUNTIMES to Yes , Absolutely ! . 

V %date%: A sentence includes another predefined variable, %date%, 
which shows today's date. 

v 0 %funtimes%: This displays the %funtimes% variable that was defined 
two lines earlier. 



Figure 14-2: 
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• Set FUNTIMES = Yes. Absolutely' 


Are we having fun on 25 Apr 2007? 




Yes. Absolutely! 







Although this is a trivial example, you can easily use these dynamic variables 
to create keys and other data for your database. 



Performing functions With Variables 

Some wiki variables are also functions, which produce varying results 
depending on what parameters you pass into them. For example, 
%GMTIME{ " $hour : $min : $sec" } % spits out the time formatted as 12:01:23. 
This variable takes parameters, processes them, and spits out a result. 

Notice how parameters, such as hour, are prefaced with a dollar sign like this 
$hour. The parameters are enclosed in curly brackets. This function tells the 
wiki engine to return the current hour, minute, and second. You'll see other 
parameters with obvious names like $year, $mo, and $day. Funky, right? For 
another example, look at this long, ugly HTML code: 

<input type= "hidden" name=" topic" 

value="BookT%GMTIME{ "$year$mo$day$hour$min$sec" }%" /> 



day, nour 

DropBodfe 

200703 
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This sets the key to this book as BookT plus the current time in year, month, 
day, hour, minute, and second. If this code runs at 1:30:25 p.m. on March 01, 
result looks like this: 



01133025 



From this you can tell that the $hours parameter is using a 24-hour military 
clock (13 for the hour instead of 01). 



Some favorites from the 
tfiki Variables Vault 

Hey, cool cats and kittens, want to take a look at some blasts from the future? 
How about rocking and rolling your own wiki to the break of dawn with the 
hip, wiki TWiki variables shown in Table 14-1? 



Table 14-1 


Some TWiki Variables 




Name 




Description 




9- T3T3 9- 




Line break. 




%BULLET% 




Bullet. 




"O ID ID "0 




Line break and bullet combined. 




%BB2 % 




Indented line break and bullet. 




%RED% text 


%ENDCOLOR% 


Colors the text between %red% and %end- 
COLOR% red. Try different colors. A nice 
GREEN, maybe? Or MAROON? 


%H% 




Help icon. 








%I% 




Idea icon. 


%N% 




New icon. 


%Q% 




Question icon. 


%U% 




Updated icon. 


%T% 




Tip icon. 


%X% 




Alert icon. 



%Y% 



Yes icon. 
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Table 14-1 (continued) 
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Description 



%ICON{ "name " }< 



Adds a small documentation graphic (such 

as edittopic, group, home, person, 
save, viewtopic) or icon of common 
attachment types (such as doc, gif, html, 
mp3, pdf , ppt, txt). 



%DATE% 



Today's date in day/month/year format: for 
example, 03 Jun 2007. 



%DIS PLAYTIME { " format " } ■ 



The format can include anything from 
$year to $sec. Hours ($hour) are in mili- 
tary time. 



% INCLUDE { "page 


"}% 


Adds the content of another page 
rent page. Useful to create a big n 


to the cur- 
nanual. 


%SPACEOUT{ 


'%TOPIC%" }% 


No, this isn't something to do with mind- 
altering substances. This variable takes the 
name — or any text in camel case — and 
spaces it out. For example, if the name of the 
topic is BabeRuthsUndies, this variable 
returns Babe Ruths Undies. 


%TOC% 




Generates a table of contents based on 
headings. 


%TOPIC% 


The name of the current topic; it gets linked 
automatically if it is a WikiWord. 



% URL P ARAM { "name" }% 



Returns the value of a URL parameter. For 
example, if you append ?lunch=Sushi to 
the URL of a topic, 

% URL p Aram { " lunch" } % returns 
Sushi. 



feWEBi 



The name of the current TWiki web. 



Many more variables are available. For a complete list, check out 

http : / / twiki . org/cgi-bin/view/TWiki /TWikiVariables 
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The %SE7 



you want to find all mentions of the words fun times in your wiki. 
The %search% variable can be used to search your wiki and return results. 
Edit any page or create a brand-new page and add this code to see the 
%SEARCH% variable in action: 

%SEARCH{"fun times" scope="text" nosearch="on" 

nototal="on" header="| *Topic: * | *Summary: * 
|" format="| $topic | $summary |"}% 

Now save the page. You should see a table of search results, as shown in 
Figure 14-3. How did this happen? 



Figure 14-3: 

Use the 

%SEARCH% 

variable to 
search your 
wiki. 
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The preceding code sample gives the variable %search% a few parameters. 
Look at the code, one piece at a time: 

- " fun times " : This is the search text. Search is not case sensitive by 
default, so it's okay to enter all-lowercase text. If you enter "fun", the 
engine will search for the word fun as well as words containing the frag- 
ment fun-, such as function or funky. It will also find words with fun in the 
middle, such as the extremely fun word profundity. 

scope= " text " : This shows where to search. Setting the scope to 
" topic " searches topic names only. Other options are " text " (to 
search in the topic text) and "all " (to search topic text and names). 
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nosearch= " on " : This parameter hides the search string, making the 
table pretty. 



otal= " on" : This hides the total number of results returned, which 
other prettification maneuver. 




header= " | *Topic : * | *Summary: * | ": This is what the header 
of the search result looks like. It is a table row with two header cells: 
Topic and Summary. 

format=" | $topic | {summary | ": This defines how each search 
result is formatted. Here, the row will show the topic name in one cell 
and the summary in another cell. 

You can use the %search% variable to automatically generate a table of con- 
tents for your wiki. Imagine creating a page in your Beatles wiki dedicated to 
Ringo. Enter the following wiki markup: 



^SEARCH { " Ringo" scope="all' 



header= 1 
f ormat= ' 



*Topic : 
$topic 



nosearch="on" nototal= 
' | *Summary : * | " 
I $ summary I " } % 



This search brings up all the topics containing the word Ringo, allowing your 
intrepid users to dynamically check for Ringo mentions in your wiki. If you 
add another Ringo page, a new Ringo mention pops up in the search results. 
And if you delete a Ringo page, Ringo goes away, just like Pete Best. 



lemplatinq \lour Wiki 



Do you ever feel like a lot of the work that you do on your wiki is redundant? 
Do you repeat yourself? Do you keep doing the same thing over and over? If 
so, you probably need some templates for your wiki. Templates simplify wiki 
page creation because they contain basic elements shared by most pages, 
and all you have to do is fill in some unique data. Templates can provide a 
predefined method of representing data, or they can serve as containers for 
automated data entry. 



Templates can be used to quickly create new pages with set contents. For 
example, suppose you wanted to create BeatlesGuitar entries detailing the 
Beatles' various guitars. Although each guitar page will have unique data, 
they share certain data categories and the basic layout. 
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A template-based application has these components: 



DropBoofcSr 



e topic, which typically contains 

A form to create new topics based on a template 

A search showing all topics that were created based on a template 
topic 



t<" A template topic, upon which new entries are based 



Creating a base topic 



You have to start somewhere. In the case of using forms with your wiki, you 
start by creating a new topic. The process takes just four easy steps: 

1. Click Create New Topic in the left bar. 

Refer to Figure 14-3 to see this link. 
A Create New Topic page appears. 

2. Name the new topic BeatlesGuitarPage and click Create This Topic 
(there's no need to specify a topic parent or a template). 

3. Enter the following content in the edit box: 

+ The Beatles Guitar Page 



New topics are based on BeatlesGuitarTemplate . 

4. Save the topic. 

A question mark link appears after BeatlesGuitarTemplate. This is an 
indication that the template topic does not yet exist. 



Creating a basic template 

After you have your base topic, the next step is to create the new template 
topic. Just follow these steps: 

1. Click the question mark after BeatlesGuitarTemplate. 

2. In the new page's editing window, enter the following: 

+! ! Guitar Name 
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* Played By: 

* Owned By: 

* Played On: (Albums) 

* Played At: (Concerts) 



-- %WIKIUSEKNAME% - %DATE% 

You now have a straightforward template. 
3. Save the template with the name BeatlesGuitarTemplate. 

The template looks like the page shown in Figure 14-4. 



Guitar Name 

• Played By: 

• Owned By: 

• Played On (Albums) 

• Played At: (Concerts) 

- rwiMGuest - 25 Apr 2007 

Making neu/ pages from templates 

Templates make it easy to quickly create new pages. In the previous section, 
we show you how to create a basic template for pages about guitars used by 
The Beatles. To create a new page based on this template, follow these steps: 

1. Click the Create New Topic link located in the sidebar. 

You see a form. 

2. In the Topic Name field, enter BeatlesGuitarsl. 

3. From the Topic Parent list, select the BeatlesGuitarPage base topic 
you created earlier. 

4. From the Use Template list, select the BeatlesGuitarTemplate template 
topic. 

5. Click the Create This Topic button. 

6. Replace the Guitar name heading with the name of the guitar. 

7. Enter some text in the Played By, Owned By, Played On, and Played 
At fields. 

8. Click Save to save the topic. 



DropBooks 



Figure 14-4: 

Templates 
simplify 
page 
creation. 
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Repeat these steps to create additional pages like this, incrementing the 
number at the end of the page name each time: BeatlesGuitars2, 

juitars3, and so on. Now you know how to create new entries based 



)late. Later, we show you how to simplify the page-creation process. 
First, though, we show you how to find the pages just created. 



Finding pages created from a template 

In addition to making it easy to create new pages, templates also simplify the 
process of finding similar pages and generating tables of contents for those 
pages. Use the bread crumbs (the links at the top of the page that show the 
path you have taken through the wiki) to go back to the BeatlesGuitarPage 
base topic. To build a table of all pages created based on the 
BeatlesGuitarTemplate topic, edit the BeatlesGuitarPage topic and enter the 
following: 



%SEARCH{ "BeatlesGuitars" scope= " topic " nosearch=" 


on" 


nototal= " on" 






header= " 


*Topic : * | *Summary:* |" 




f ormat= " 


$topic | $summary |"}% 





When you save the topic, you see a table listing all pages with BeatlesGuitars 
in the name, as shown in Figure 14-5. Simply click a page name to view that 
page. 



Figure 14-5: 

Search for 
all files 
created 
from a 
specific 
template. 
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Yamaha Played By: George Owned By. George Played On: Sgt. 
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Simplifying page creation 



vious section, we show you how to create a new page from a tem- 
'using the Create New Topic link located in the sidebar. Using an 
HTML form is a much easier way to create new pages from templates. Edit the 
BeatlesGuitarPage base topic again and add the markup shown in Listing 14-1. 



Listing 14-1: Using an HTML Form to Create a New Page from a Template 

<form name="new" action="%SCRIPTURLPATH{edit}%/%WEB%/ "> 

New guitar topic: 

<input type="text" name=" topic" 

value= " Beat lesGui tar s%SERVERTIME { $yearx$mox$day } % " si ze= " 3 6 " / > 
<input type= "hidden" name="templatetopic" value="BeatlesGuitarTemplate" /> 
<input type="hidden" name="topicparent" value="%TOPIC%" /> 
<input type="hidden" name= " onlywikiname " value="on" /> 
<input type="hidden" name="onlynewtopic" value="on" /> 
<input type="submit" class="twikiSubmit" value=" Create" /> 



New topics are based on BeatlesGuitarTemplate. 
</form> 



Save the page. This basic HTML form creates a text entry box like the New 
Guitar Topic text entry box in Figure 14-5. The form asks for a name which 
will become the name of a new page when you click Create. 

The form has a visible input field named topic. It specifies the name of the 
topic you are going to create. The form field value is defined as 

BeatlesGuitars%SERVERTIME{ $yearx$mox$day}% 

It contains a variable that generates a topic name based on a date, such as 

BeatlesGuitars2 007x04x24. 



The form also contains several hidden input fields and a submit field: 

templatetopic: This value specifies the template to be used when cre- 
ating the new topic (BeatlesGuitarTemplate, in this example). 

^ topicparent: This value specifies the parent of the new topic. The 
value is set to the variable %topic%, which expands to the current topic 
name BeatlesGuitarPage. 

onlywikiname: If set, the form rejects any topic name that is not a 
WikiWord. 
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u* onlynewtopic: If set, the form rejects any topic name that is already 
taken, preventing you from overwriting existing topics. 



kiit: This input produces the Create button, which submits the form 
to the wiki engine. 



Forms can do much more than create pages, as we show you in the following 
section of this chapter. 



Adding Forms to \lour Wiki 

Forms are a natural extension of wiki templates. They provide a way for users 
to add content in a structured way. After you structure your content, you can 
run meaningful queries on it. Forms are, in many ways, the marriage of wikis 
and databases. They enable users without programming experience to create 
wiki applications, such as to-do lists, project trackers, inventory systems, 
and more. 

A form-based wiki application consists of a set of topics that have the same 
type of form attached to the topics. This set of topics represents a database 
table. The form is custom designed for each application and might contain 
edit fields, radio buttons, pick lists, date fields, and other widgets. A custom 
query can pull content from the set of topics and display the form fields in 
table format. 

Building a form-based application using TWiki is a seven-step process, as 
described in the following sections. The basic steps are 

1. Create a home page for the database. 

2. Define the form. 

3. Enable the form for a wiki web. 

4. Create a template topic. 

5. Add the form to the template topic. 

6. Build an HTML form to create new topics based on the template topic. 

7. Build a formatted search to list topics that share the same form. 
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Creating a database home paqe 

Istep in building a form-based wiki application is to create a new 
ige for the database. In this example, we show you how to create a 
database of Beatles fans: Collect the fans' names, their favorite Beatle, their 
Super Fan status, and their Beatles' story (how they became enamored with 
the Fab Four). Create a new page and enter the following markup: 

+! ! Beatles Fan Forum 

* BeatlesFanForm 

* BeatlesFanTemplate 

After saving this page, BeatlesFanForm and BeatlesFanTemplate become 
subtopics. These two subtopics are key to creating a database of fans. 



Defining a form 

After you create a database home page, you're ready to start building the 
form. Continuing with our running example; do the following: 

1. Click the question mark after BeatlesFanForm to create the form def- 
inition topic. 

In TWiki and most other wikis, links are automatically created for words 
in camel case: for example, BeatlesFanForm. If the link points to a page 
that does not yet exist, you may see a question mark after the word. 
Every wiki engine is a little different, but TWiki uses the question mark. 
For more on camel case and wiki links, see Chapter 7. 

2. When an edit window for a new page opens, enter the following 
markup: 

+!! Beatles Fan Form 

| *Name* | *Type* | *Size * | *Values* | *Tooltip message* | 
| FanName | text | 40 | | The Fan's Name | 

| FavoriteBeatle | select | 10 | , John, Paul, Ringo, George, Yoko, 
Mick | Favorite Beatle | 

| SuperFan | radio | 2 | yes, no | Is this fan a Super Fan? | 

| FanStory | text | 100 | | How they came to love the Beatles | 
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See also: BeatlesFan, BeatlesFanTemplate 
3. Save the page. 

Something that looks like Figure 14-6 appears. 
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Figure 14-6: 

This form 
definition 
defines the 
form. 
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So what is this mess? What you see here is a form definition. The rows in the 
Form definitions table shown in Figure 14-6 define the fields of our simple 
database: FanName, FavoriteBeatle, SuperFan, and FanStory. Each field needs 
to be defined as follows: 

V Name: As the name implies, this column contains the name of each form 
field. 

V Type: This column defines the type of the form field. Types include 

• text: A single-line text entry box 

• select: A pull-down menu with specific selectable options 

• checkbox: Check boxes (surprise!) 

• radio: Mutually exclusive radio buttons 

• label: Read-only text 

• date: A text field with a date picker 

• textarea: A multiline text box 

f Size: This column specifies the size of the data field. For example, the 
FanName text box will be 40 characters long, and the FanStory text 
area will be 100 characters long. For type select, it is the vertical size 
of the select box. 
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I Values: The select input type requires defined values. In the example 
here, we added a few possible values for selection, including Mick for 




e folks who might have stumbled upon the wrong fan club. 

ltip message: This is what shows up next to the mouse pointer 
when you scroll over a column name. This is a good place for short help- 
ful tips or comments. 



Enabling a form 



After you define a form, you must enable it for a web on your wiki. In TWiki, 
you start by telling the wiki engine that you created a new form using the 
WebPreferences page. Follow these steps: 

1. Click the Preferences link in the left-hand navigation area of your 
wiki. 

2. Scroll down to locate the WEBFORMS setting. 

You should see a list of topics with names ending in Form. 

3. Edit this page to add BeatlesFanForm to the WEBFORMS setting. 
Don't worry. You won't bust anything. 

4. Save the WebPreferences page. 

It will look like Figure 14-7. 



Figure 14-7: 

Add your 
form to the 
WEBFORMS 
variable. 
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Creating a template topic 

After creating your form, you're ready to create a template topic. Later, we 
show you how to create a form that uses this topic as a template. Each time 
someone creates a new Beatles fan entry, it will be based on this template 
topic. 
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To create a template topic, follow these steps: 
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rn to the BeatlesFan home page created earlier in this chapter, 
the question mark next to BeatlesFanTemplate. 

A new topic is created. 
3. Enter the following markup: 

+!! Beatles Fan: %FORMFIELD{FanName} % 



Rock out, Beatles Fans. Back to other BeatlesFans 



h+ Feedback 



%COMMENT% 



— %WIKIUSERNAME% - %DATE% 




4. Don't save the page yet! 

If you're curious, the markup you entered will render as shown in Figure 
14-8. This markup serves as a placeholder for new topics that are cre- 
ated based on this template. 

In the following section, you'll take this template to the next level by adding a 
form. 



Figure 14-8: 
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Adding a form to the template topic 
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evious section, we show you how to create a basic template and 
e placeholder text. Earlier in the chapter (in the "Defining a form" 
section), we show you how to create a form definition. Now, you're ready to 
put the two together: 

1. Click the Replace Form button to display a list of enabled forms, as 
shown in Figure 14-9. 



Figure 14-9: 
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2. Choose BeatlesFanForm and then click Select. 

This puts you back into edit mode, where you will see the form attached 
to the topic just below the edit box. 

3. Don't enter any data at this point — simply save the topic. 



Building an HTML form for topic creation 

You're almost ready to take your form-based wiki application live and let 
people use it. But how will users get started? Starting with a simple HTML 
form, as shown in Figure 14-10, guides users down the right path. 
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F igure 14-10: 
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1. Return to the database home page created earlier in this chapter. 

Its markup looks like this: 

+! ! Beatles Fan Forum 




* BeatlesFanForm 

* BeatlesFanTemplate 

2. Edit the page and add the following markup to the end: 

<form name="new" action^ " %SCRIPTURLPATH{edit}%/%WEB%/ "> 
* New Beatles fan: 



< input type= 

< input type= 
/> 



< input type= 
<input type= 
< input type= 



text" name= " topic " value="BeatlesFanl001" size="26" /> 
hidden" name="templatetopic" value=" BeatlesFanTemplate" 



"hidden" name= " topicparent " valuer " %T0PIC% " /> 
"hidden" name="onlywikiname" value="on" /> 
"hidden" name="onlynewtopic" value="on" /> 
<input type=" submit" class="twikiSubmit" valuer "Create" /> 
</form> 

The input field with the name templatetopic tells the form what tem- 
plate to use — in this case, BeatlesFanTemplate — when the user 
clicks Create to create a new topic. 

3. Save the page. 

You'll see that a default topic name (BeatlesFanlOOl) is already 
entered in the text box, as shown in Figure 14-10. You may change the 
BeatlesFan number to another number and test the form by clicking 
Create. A form like the one in Figure 14-11 appears. 
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Figure 14-11: 
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Building a formatted topic list 

Perhaps the most important benefit of both templates and forms is standard- 
ization. If you let people enter whatever text they want, chances are you 
won't get the same kinds of information from everyone. Standardization 
means collecting the information you want in a structured way. Templates 
standardize pages, and forms standardize the data that you collect from 
users. And with standardized data, you can easily build a formatted search to 
list related topics. In the previous sections of this chapter, we show you how 
to build a form to collect data from Beatles fans. You can easily build a for- 
matted list of all the topic pages created by this form. Open the BeatlesFans 
home page for editing and add the following markup: 



%SEARCH{ "BeatlesFan[0-9] " type="regex" scope= " topic " 


nosearch= 


="on" nototal="on" 


header= " 


*Topic : * | *Summary:* |" 


f ormat= " 


$topic | $summary |"}% 



The type="regex" parameter enables a so-called regular expression search. 
The actual search string is BeatlesFan [ 0-9 ] . It basically means that the 
engine searches for BeatlesFan, followed by any number. When you save 
the page, the result looks like Figure 14-12. Every time a user loads the 
BeatlesFans home page, a search is performed, and an updated topics list is 
displayed. 
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Figure 14-12: 
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Beatles Fan Rock out. Beatles Fans 
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Improving the topic list 

Although functional, the forms and topic list generated in the previous sec- 
tions are not yet very user friendly. Several things can be improved: 

v 0 The search that generates the topic list just shows the linked topic with 
summary We would like to add other data such as fan names or favorite 
Beatles. 

i>* We do not want the user to have to type the next free number each time 
a new entry is created. 

*** It would be nicer to simply fill out a form on the BeatlesFan home page 

I with all details, click Create, and return to the home page with an 
updated list. 

Spice things up a bit. Use the $f ormf ield ( ) variable in the format parame- 
ter of the search. This is an odd variable that has direct access to form items. 
Edit the BeatlesFan home page and replace the % search variable and HTML 
form with the markup shown in Listing 14-2. 



Listing 14-2: Improving the Beatles Fan Form 



+! ! Beatles Fan Forum 

aSEARCH{ " BeatlesFan [ 0-9 ] " type="regex" scope= " topic " 

excludetopic="BeatlesFanTemplate" nosearch= "on" 
nototal= " on" 



header= 1 
Beatle* 



^Entry* | *Fan Name* | *Favorite 
^Super Fan* | *Fan Story* | " 

(continued) 
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format=" | [ [$topic] [ 

%PUBURL%/%TWIKIWEB%/TWikiDocGraphics/viewtopic . 
gif ]] | $formf ield (FanName) 
$formfield (Favor iteBeatle) 

$formf ield(SuperFan) | $f ormf ield (FanStory) 
|"}% 



<form name="new" action="%SCRIPTURLPATH{save}%/%WEB%/ "> 
*Add New Beatles Fan* | | 

Fan Name: | <input type="text" name= " FanName " value="" 

size="60" /> | 
Favorite Beatle: | <select name="FavoriteBeatle" 
size= " 6 " > <option>John</option> 
<option>Paul</option> <option>Ringo</option> 
<option>George</option> <option>Yoko</option> 
<option>Mick</option> </select> | 
Super Fan: | <input type=" radio" name=" SuperFan" 
value="yes" /> yes, <input type="radio" 
name= " SuperFan" value="no" checked= " checked" /> 
no | 

Fan Story: | <input type="text" name= " FanStory " value="" 

size="60" /> | 
| <input type=" submit" class= " twikiSubmit " 
value= "Create " /> | 

"hidden" name=" topic" 
BeatlesFanAUTOlNClOOl" /> 
"hidden" name= " templatetopic " 
BeatlesFanTemplate" /> 
"hidden" name= " topicparent " 
%TOPIC%" /> 

"hidden" name="onlywikiname" value="on" 



</ 



<input type= 

value= 
< input type= 

value= 
< input type= 

value= 
< input type= 

/> 

< input type= 

/> 

< input type= 
value= 

f orm> 



"hidden" name= " onlynewtopic " value="on" 

"hidden" name="redirectto" 
%TOPIC%" /> 



For administrator only: 

* BeatlesFanForm 

* BeatlesFanTemplate 



Notice that the HTML form has a hidden field named topic with the value 
BeatlesFanAUTOlNClOOl. AUTOINC1001 is a special keyword telling TWiki 
to look for the next free number starting with 1001. By using this keyword, 
you can auto-generate the topic names. 
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After you save the topic, you see a table listing all Beatles fans and a form to 
add a new entry, as shown in Figure 14-13. 



Figure 14-13: 

The Beatles 
fan input 
form has 

been greatly 
improved. 



Beatles Fan Forum 



Sally Smith Yoko 

Joe Jones John 

Bill Billy George 

Jimmy Newtron Paul 

= Jom Cruise Yoko 



no Yoko is my fave. 

yes Wow, the Beatles are great 

yes Incredible character 



Add New Beatles Fan 



John 




Paul 




Km go 




George 




Yoko 




Mick 





Super Fan r yes. d no 




Fan Story 


I 


Create 





This is an example of a truly powerful TWiki application made with our 
simple form and template pages. Feel free to experiment with the markup to 
see how you can apply it to other uses. 



Adding Wiki Plug-fas 

Much of a wiki's power comes from its simplicity. But there may come times 
when you want more features than those provided by your wiki's basic fea- 
ture set. Some wiki engines (such as TWiki) support cool plug-ins that quickly 
and easily expand the wiki's power. You might be familiar with Web browser 
plug-ins such as Flash or QuickTime that allow your Web browser to do more 
than just browse HTML pages. Wiki plug-ins work in a similar manner, but 
they are installed on the wiki server, not in your browser. The next couple of 
sections show you a few TWiki plug-ins to whet your palate. 
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CommentPIugin 



tPlu gin is preinstalled in the TWiki engine, so it's ready to be used 
y. (We use it in this chapter; refer to Figure 14-8.) This plug-in allows 
you to add content to a topic quickly without an edit/save cycle. For example, 
if you're writing a design document in the wiki and would like to solicit feed- 
back, you can do that by adding this at the bottom of the design document: 



%COMMENT% 



This single line of markup shows a comment box with an Add Comment 
button. Users can quickly leave comments. 

CommentPIugin has many ready-made templates to capture content in a vari- 
ety of formats, such as bulleted lists and tables. You can even define your 
own input form and output format. The CommentPIugin topic located in the 
TWiki web explains all the details and features of this cool plug-in. 



SpreadSheetPtuqin 

Like CommentPIugin, SpreadSheetPlugin is preinstalled with the TWiki engine 



and is ready to use. It allows you to add spreadsheet syntax to tables. For 
example, you can create a table like this: 




*Region : * 
Northeast 
Northwest 
South | 2' 
Europe | f 
Asia | 22( 
Total: c - 


*Sales:* | 

320 

580 
10 | 
510 | 
) 1 

sCALC{ "$SUM( 




$ABOVE ( ) 


)"}% | 





When you save this page, the %calc { " SUM ( $above ( ) ) " } % markup is 
replaced with the sum of the preceding cells. The operation in this case is 
$SUM. (Note that if you want to right-justify the numbers, as we did for the 
sales column, you'll need two spaces after the vertical bar.) Other available 
operations include 

i>* $int: Rounds a number to nearest integer 
is 0 $ lower: Converts a string of text to lowercase 
i>* $max: Returns the biggest value of a list of numbers 
$rand: Returns a random number 
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There are many more functions — over 70 in total. The SpreadSheetPlugin 
topic in the TWiki web documents all functions of this versatile plug-in. 

readsheet programs, you are not confined to tables; you can add 
; anywhere in the topic text. For example, you can use $if to output 
text only if certain conditions are true. Here's an example. You might want to 
display a cross-reference to another topic. To avoid confusing your readers, 
though, you want to make sure that the topic exists first — thus, avoiding the 
problem of automatically generating something like See ThisUnusableLink. If 
you want to show a link to another topic only if that topic exists, you would 
use the following markup: 

%CALC{"IF( $EXISTS (Sandbox. DiscussionTopic ) , See 
Sandbox . DiscussionTopic ) "}% 



DropBooks 

functions 



EditlablePiuqin 

Wouldn't it be nice to be able to edit just one table instead of a whole topic? 
You can do that with the EditTablePlugin, which is another preinstalled, 
ready-to-use TWiki plug-in. To try it, type the following: 



%EDITTABLE{ }% 

*Tasks* | *Status* | 

Give flowers | Done | 

Buy digital camera | On Hold | 



This plug-in displays an Edit button below the table. (It's worth typing this 
markup to see the button!) When the user clicks Edit, an editable spread- 
sheet appears. You can also add some structure to the editable table with 
this markup: 

%EDITTABLE{ format="| text, 30 | date, 10, 

%SERVERTIME{ "$year-$mo-$day" }%, %Y-%m-%d | 
select, 1, New, In Progress, On Hold, Done | 
text, 2 0 p }% 
*Tasks* | Completion Date* | *Status* | *Notes* 
Give flowers | 2007-03-20 | Done | none | 
Buy digital camera | 2007-03-30 | On Hold | none | 



When the user clicks Edit under this table, the editable fields include date 
pickers and pull-down menus, as shown in Figure 14-14. See the 
EditTablePlugin topic at TWiki for more on using this helpful plug-in. 
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Figure 14-14: 

The 
EditTable- 
Plugin adds 
advanced 
features to 
editable 
tables. 
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InterurikiPtutyin 



Wouldn't it be nice to simply type ISBN:978-0-470-04399-8, Wikipedia: 
Switzerland, and Google:alphorn, and have it linked automagically to a book 
description, a Wikipedia article, and a Google search, respectively? That is 
exactly what the pre-installed InterwikiPlugin does. You can also add your 
own rules, such as Bug : 12345, to link to your bug-tracking database. For 
more on this plug-in, visit the InterwikiPlugin topic in the TWiki web. 



TWikibmutPluqin 

This plug-in isn't preinstalled, but it's worth the effort! You can add a Java- 
based drawing editor to your wiki, as shown in Figure 14-15, by using 
TWikiDrawPlugin. Simply add the variable %drawing{ name] % to any page, 
replacing name with any name you like. When the page is saved, an empty 
drawing appears. When you click the drawing, a Java applet editor appears 
like the one shown in Figure 14-15. You can draw many different shapes, and 
you can even link shapes to other pages. When you click the Save button, the 
drawing is attached to the topic. For more on the TWikiDrawPlugin, see its 
topic page in the TWiki web after downloading and installing from TWiki.org. 
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Finding more piny-ins 

Many more useful plug-ins are available on TWiki.org. To see what's available, 
check out 

http : / /twiki . org/cgi-bin/view/Plugins/PluginPackage 

A few noteworthy plug-ins include 

& ActionTrackerPlugin: Track action items, run queries, and notify people 
of pending action items 

BlackListPlugin: Utility to keep malicious users away from a public 
TWiki site 

t^* CalendarPlugin: Monthly calendar for teams 

f" ChartPlugin: Embed charts into wiki pages 

DatabasePlugin: Secure read and write access to data in an SQL database 

V HeadlinesPlugin: Embed RSS (really simple syndication) news feeds 
into wiki pages 

ImagePlugin: Control the display and alignment of images using an easy 
syntax 

v 0 SectionalEditPlugin: Edit sections of a topic, one at a time 

TreePlugin: Dynamic generation of TWiki topic trees 

TwistyPlugin: Twisty section JavaScript library to open and close content 
dynamically 

TagMePlugin: Tag wiki content collectively to find content by keywords 
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In this part . . . 

7 his part summarizes key information about wikis that 
gets to the heart of what wikis are all about and how 
to put them to work. We explain essential wiki attitudes so 
you know how to think in a wiki-way. We also present the 
common roles that people play so you can walk the wiki- 
walk in the style that suits your personality. We conclude 
with some tips on how to put wikis to work in your office 
and then take you on a tour of some exotic wikis. 
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In This Chapter 

Collaborating in an easier environment is better 

Receiving feedback on unfinished work 

Being bold, setting examples, and letting it happen 

Having patience: Structure can wait 

Following the community 



7 he mechanisms of wikis are so simple. After you understand them, it's 
hard to fathom how such a small set of functions could have such a large 
effect. Of course, the simplicity and ease of use of wikis is a big part of the 
success of the concept. However, another part of the story might be more 
important: Over and over, groups of people who use the simple mechanisms 
of wikis become more productive because new attitudes crop up. When faced 
with a wiki, people make new assumptions that lead to new ways of working 
and creating huge benefits for millions of people. Here are the ten wiki atti- 
tudes that we think are most important. 



Shared Authorship 

"Look at this great article I wrote," is a natural thing for any author to say, but 
it's also a statement that doesn't reflect the wiki attitude of shared authorship. 
Comparatively, "Look at this great article that we created," is a statement that 
reflects how most people involved in a wiki feel about the content that was 
created. This genuine feeling of shared authorship and ownership of the con- 
tent is something that is profoundly unnatural at first because we're all 
trained that writing is a solitary process, reflecting only the contents of our 
own minds. When you get involved in a thriving wiki, though, this attitude can 
fade away and leave you with a sense of collective pride in having helped 
create something that is much larger than any one person could do alone. 
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iu compare wikis with most word processing programs or content 
management systems, you see how easy and simple wikis really are. Wikis 
have only a fraction of the functions of more complicated systems, but less 
functionality leads to way more content because wikis remove the barriers 
to involvement. Making everything as easy as possible is an essential wiki 
attitude. 



Throw It Up There 

Wikis are lifeless unless someone takes action by creating and posting con- 
tent, but we're all sometimes afraid to publish. What if my article isn't any 
good? What if it's wrong? What if somebody doesn't like it and says some- 
thing mean about it? Just toss those fears in the trash can, friend. Throwing 
content up there to see what happens is an essential wiki attitude. Don't 
worry whether it is bad or wrong or provocative. Other people on the wiki 
will let you know soon enough, and they will probably be pretty nice about it. 



Unfinished Is Okay 

One common barrier that prevents people from putting content on a wiki 
deserves special mention. Frequently, people don't feel comfortable putting 
up a piece of content until it's "done." On wikis, content is never "done." Even 
if you think it is done, it ain't done. After you post something, the community 
will probably make it better. So why wait until you are done to get help from 
others? Posting unfinished content is a key wiki attitude, one that reflects 
that Japanese concept of wabi-sabi: the beauty of imperfect, impermanent, 
and incomplete things. As soon as you have a good start on an idea, outline, 
or draft, get it on the wiki and see how other brains react to it. 



Bald Is Beautiful 

Do not be shy. Do not be afraid of offending somebody by changing his con- 
tent. Do not be worried what others will think. To be bold, to take action, to 
make corrections, to get involved, and to make it happen are wiki attitudes 
that get people involved and give a wiki a sense of motion. Without bold com- 
munity members, nothing happens on a wiki, and it withers and dies. 
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pie are new to a wiki, they don't know all the necessary wiki atti- 
tudes. They don't know that they should be bold, post unfinished content, 
and adopt all the other wiki attitudes. How will they know? How will they 
learn? You will teach them. Set an example to others who are new to a wiki. If 
someone sends you an e-mail that should instead be on the wiki, post it for 
her and tell her. Direct her to content you have posted. People become part 
of a wiki community by imitating others. Be an example for others to imitate. 
Take the message to them. 



Let It Happen 

Say that you are one of the cognoscenti for your wiki. You were there when it 
was founded. You helped write some of the early content and recruited others 
to join the fun. Now new kids are joining the party, and you have been setting 
an example for them. But wait, they aren't doing it just the way you did. They 
have new ideas and are starting to write pages that seem a bit strange and to 
change some of the things you wrote long ago. Yes, you must be bold and 
unafraid to disagree. However, in your position of respect as a wiki champion, 
you should not be too quick to quash the energy of the newly hatched com- 
munity members. Letting it all happen is a good policy. 



Structure Cart Wait 

After you become a wiki expert, you will see just how much you can do with 
each page of your wiki. You can add tables. You can e-mail content. You can 
put in forms and treat pages like databases. The problem with all these pow- 
erful ways to craft wiki pages is that they are at war with the simplicity that 
makes wikis succeed in the first place. When people try to edit a page with a 
lot of structured wiki elements, they can get scared. Remember that adding 
structure to wikis can wait. Don't be too hasty to introduce advanced wiki 
elements until you are absolutely sure that they will provide a big payoff and 
not chase people away. 
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of wiki pages is not the only thing that can wait. After a community 
gets going, powerful urges emerge in the founders to direct the work of 
others. When you look closely at communities in advanced stages, such as 
Wikipedia, you find quite a bit of structure to the processes that run the site. 
Well-defined roles exist as well as governance processes for resolving dis- 
putes and making policy decisions. Remember that structure should emerge 
from the bottom up — not be inflicted from the top down. 



Fottout the Community 



This last attitude applies to those who would be wiki champions and brings 
together the spirit of many of the attitudes expressed in this chapter. Even if 
you're the person who started the wiki, don't act like that gives you special 
rights to be the boss. Linus Torvalds, the creator of Linux, is a master of 
understatement in his leadership of the Linux development community. 
When eager programmers would ask him, "What can I do to get involved with 
Linux?" or "What part of Linux should I work on?" his answer would usually 
be, "Let me know when you find out." 



In suppressing the urge to give people direction, even to those who wanted it, 
Torvalds strengthened the community he founded by allowing each individual 
to find his or her own way to the right activity. If he himself directed them, 
they might end up doing the wrong thing and bowing out. So, if you are lucky 
enough to create a useful wiki, don't be the boss. Rather, be just another 
member and follow the community where it goes. 
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In This Chapter 

Reading, contributing, or telling the world about your wiki 
Performing QC or admin duties 
Hosting the wiki or developing its engine 
Creating policies or criticizing the process 
Founding the wiki 



■ il/hen wikis succeed, they do so to a large degree because they meet the 
WW needs of so many different kinds of people. With a wiki, whatever your 
inclination, there is always a way for everyone to chip in and add his and her 
special talent or knowledge to the mix. If you look at any successful wiki com- 
munity, whether it be Wikipedia or an internal wiki inside a company, you will 
find many different people playing many roles. This chapter is a catalog of 
those roles that might suggest new ways of having fun with wikis other than 
those that have already occurred to you. 



Reader/Researcher 

The most common role that most of us play when interacting with wikis is 
that of a reader or researcher. We want to find out something, so we use our 
favorite search engine and are directed to a wiki. Much of the time, people 
who find information this way don't know that they're using a wiki. They just 
see a nicely formatted page with the information they seek. This is as it 
should be. The content of a wiki is always more important than the form. 

After you see a page, though, knowing that it is part of a wiki and was created 
by people in a self-organizing community, you might be ready to put yourself 
and your knowledge out there and become a contributor. 
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tors to wikis are those of us who have something to say or have 
knowledge that we're burning to share. Contributors read wiki pages and 
click that Edit button to make them better. Contributors start new pages and 
do their best to fill them out. Contributors make comments on pages in wikis 
that have discussions attached to pages. What contributors inevitably find is 
that other people created those pages or are reading them. It doesn't take 
long after you are a wiki contributor to start meeting and interacting with 
other people who are drawn to the same pages that you are. 



Etfanqelist 

The excitement of learning, sharing, and creating knowledge as well as collab- 
orating to get work done often leads readers and contributors to want to 
spread the word — to become wiki evangelists. For public wikis, this can 
mean something as simple as linking from other Web sites or blogs to pages 
on the wikis. For wikis inside the boundaries of companies or other organiza- 
tions, it can mean helping to make others aware of what is on the wiki and 
how that content can be used to help them do their work. Most people who 
use a wiki regularly become evangelists because they start bringing others 
into the wiki or driving people to the content they have helped create. 



Editorial Quality Ma</en 

A wiki is only as good as the information on it. With an active wiki, tens, hun- 
dreds, or thousands of people might contribute content. Some contributions 
will be better than others. Some will be brilliant, and others will be sloppy or 
just plain wrong. In most successful wikis, a quality control patrol springs up. 
This patrol is staffed by people who care about the quality of the information 
on the wiki and who know how to use the Recent Changes button to good 
effect. The quality control patrollers look at changes made to the wiki and 
examine them to make sure that they are accurate and meet the standards of 
the other content on the wiki. 
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is get active, all sorts of maintenance tasks spring up. New users 
must be given accounts. Special tasks such as archiving old content or per- 
forming bulk changes must be performed. New wikis must be set up and old 
wikis must be taken down. Permissions to who can see which wiki must be 
changed. New extensions to wiki functionality must be installed and brought 
into production. Administrators are the equivalent of the auto mechanics of 
wikis who make all this happen. 



Operations and Hosting Engineer 

Wiki engines run on servers. A slow wiki or one that is unreliable isn't likely 
to be successful. It's not uncommon for a wiki to fall into disuse after just one 
major outage shakes the confidence of the community of users. When a wiki 
becomes popular, the server should be enhanced to keep pace. Operations 
and hosting engineers — who keep the servers on wiki engines humming 
along — are key players in a wiki community. 



Wiki Engine Dei/eloper 

Wiki engine developers are the programmers who create the wiki engine in 
the first place and who continue to develop it by adding functionality. 
Developers can also help by tailoring the wiki to meet the needs of the com- 
munity. When wikis are used to support communication, project manage- 
ment, and work flows in organizations large and small, the bells and whistles 
that many wikis offer become invaluable. In addition to the basic functions of 
a wiki, features such as calendars, alerting mechanisms, task tracking, meet- 
ing minutes, easy commenting, and simple work flow systems can amplify 
productivity immensely. 



Policy and Process Contributor 

Wiki communities not only have computer plumbing, but they have social 
plumbing, too. In most active wikis, natural disagreements (that people in 
most communities have) soon express themselves in the context of the wiki. 
If disputes are not handled in a fair manner that satisfies everyone involved, 
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people might be driven away from the wiki, possibly decreasing its value. 
Policy and process contributors, the people who worry about setting up poli- 
processes (often by example but sometimes formally), play a crucial 
eping a wiki running. The larger the wiki is and the more people 
involved, the more important this role becomes. 



Critic 

Not everyone likes working with wikis. Not everyone likes the communities 
that form around them. Critics look at wikis from the outside and point out 
where they fail and how they fall short of their stated mission. This can be a 
valuable service to those who want to make wikis work as well as they possi- 
bly can. 



Champion/Founder 

The wiki champion or founder is the person who fought the battles needed to 
get the wiki up and running, recruited the initial participants, seeded the con- 
tent, found servers to use, set up the software, and did whatever it took to 
get the wiki going. In almost every wiki community, the champion or founder 
plays a special role and provides the crucial energy to keep the community 
moving forward and the cool head to resolve disputes. 
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In This Chapter 

Shared repository 

Reducing "To All" e-mails 

Simple databases 

Knowledge management 

Training 

Intranet 

Web publishing 

User documentation 

Shared spreadsheets 

Project management 
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■ M /hen wikis take root in the workplace, they are usually started by one 
▼ ▼ person or a small team for a single project. Months later, those wiki 
pioneers discover that someone else in the organization is also using a wiki 
on a different project. Then a third team in a satellite office turns out to be 
using another one. It's possible that none of these teams is using the same 
wiki — for example, one team uses TWiki while another is happy with 
MediaWiki. Still, by and large, they use each wiki for the same basic purposes 
and to achieve similar goals. 



This chapter is about those ten most commonly used functions of wikis among 
groups who are working within an organization to maximize efficiency, mini- 
mize duplicated effort, make collaboration easier, and achieve a common goal. 
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loment to remember how a business without a wiki stores informa- 
tion. For example, Kip in Accounting has a document on his hard drive that 
would help you finish an expense report. And Parker-Lulu in HR sent the 
latest update to the holiday leave regulations via e-mail — now which folder 
did you put it in? Josiah, the Marketing lead from your own team, has the 
only copy of your most recently edited pitch, and he's on vacation. You get 
the point: A huge amount of important information is stored on individual 
hard drives and spread across an organization. Using intranets sometimes 
alleviates these problems, but they are rarely used to the extent that a wiki is. 

Wikis can store, manage, and organize information in a way that moves vital 
data off the hard drive and into a shared space. Wikis are as flexible as a 
desktop file and folder system, and you can search them by keyword. Wikis 
can contain every type of file you have access to. Better yet, if you move the 
documents from files right into wiki pages, people can write directly into the 
wiki itself. All the information is accessible all the time. It is the one source of 
information for an entire office. 



There are lots of advantages converting documents stored in word process- 
ing files into a wiki (aside from helping to avoid the Where did I put that? syn- 
drome described here). Documents that reside in wiki pages can be used to 
contain the sort of information that changes all the time, which can avoid cre- 
ating a new set of printed or electronic documents for each revision, which 
can be costly and time consuming. By placing them on a wiki — not as attach- 
ment files but rather as text that can be edited on the wiki itself — they 
become living, breathing documents. Procedures can be changed as they 
evolve. Policies can be updated soon after they are determined. What's more, 
sections of each manual can be organized and tagged. That way, the person 
reading the manual doesn't have to wade through pages of useless material in 
order to find that one tiny piece of information that is relevant to his query. 



Reducing "To Att" E-Mail 

To: All 

From: Kip in Accounting 

Subject: 23rd Floor Refrigerator 

Would whoever ate my Frogurt please replace it? 

Sincerely, 

The Kipster 
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Sometimes, you will come across an e-mail that everyone in a company 
should read. Unfortunately, the entire company usually has to read e-mail 
really shouldn't. By moving this sort of communication onto the 
pie at the office can be more productive and in control of their time. 




Lots of wikis include the ability to create newsfeeds or alerts that appear 
whenever a person logs on. By using this mechanism, you can ensure that 
people are made aware of important updates without forcing them to actively 
check a news page. Now, please replace that Frogurt. 



Simple Databases 

Wiki pages are ultimately flexible. Although most of the time, you think of 
them as documents, there is no reason you can't use them for simple data- 
bases. For example, say you're doing some hiring, and you sorted through 
100 candidates to get to the 20 whom you want to interview. To make a 
simple database, just create an index page and link to 20 pages, one for each 
candidate. Then, during the interview process, everyone can post their notes 
about each candidate to see what others said. This simple technique can be 
used to quickly create databases to track contracts, nondisclosure agree- 
ments, the software installed on computers — whatever you want. Because 
wiki pages are so easy to create, almost any one can whip up a simple data- 
base. Comparatively, using a database program to create equivalent data- 
bases is much harder to create and to share. 



Knowledge Management 

After many years of dedicated service, Kip is taking his Frogurt and leaving 
the company to pursue his dream of becoming an acrobat in Cirque du Soleil. 
You have just weeks to find his replacement and get Kip to transfer all his 
knowledge to that new person. This happens all the time, and it shouldn't. 




Now, imagine that Kip had been using the wiki as a shared e-mail repository, 
as a place to put the accounting department's policy and procedure manuals, 
and also as a way to organize and manage projects and contacts. Instead of 
having to transfer all the data in his head, the new accounting chief would 
have an entire library of information to page through and learn from. 

The longer a wiki is used by a company, the more valuable it becomes. 
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goes hand-in-hand with knowledge management. Kip, being the wiki 
champion that he was, created a training guide that he used whenever a new 
employee joined his number-crunching staff. Because it existed on the wiki, it 
was easy to update with new information, such as phone numbers, policies, 
and procedures. Now when Kip leaves the company, instead of passing along 
a dusty and outdated training manual, his replacement can work from a wiki 
that has grown along with the changes in the company 



Intranet 



Replacing a corporate intranet with a wiki mostly benefits the IT staff. 
Because a wiki is accessed through a Web browser and does not require any 
customization of the user's desktop, far fewer Help Desk calls are needed. 
Intranets are also notoriously prone to crashing, with hiccups that slow a 
user's machine to a crawl. Because wikis use Internet protocols, they are 
often more stable than office-wide networks. Users often confuse the folders 
on their own desktop with those that exist on an intranet. This leads to dupli- 
cated or conflicting documents when users save files locally and then make 
changes. This is much less likely to occur on a wiki because the content does 
not sit on the user's desktop, and it is easier to keep track of updates and 
changes in a given document or project area. 



Web Publishing 

Because wikis are Web based, they do a great job of acting like Web sites. 
A wiki can be used as an internal and secure Web for employees to use for 
accessing everything from departmental contacts to holiday schedules. And 
it can also be used as a way to reach customers on the other side of the fire- 
wall. DokuWiki, TiddlyWiki, and TWiki all have built-in support for publishing 
Web pages and syndicated RSS (really simple syndication) feeds. 

RSS feeds can be used in the following ways: 

V An internal Web site to keep employees abreast of industry news 

Externally as a way to avail customers of the latest news about the 
company 
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rated content has become an Internet buzz-phrase. In a nutshell, it 
refers to Web sites that encourage visitors to create text, images, or sounds 
for the enjoyment of other visitors. This creates a never-ending cycle of 
(sometimes) entertaining content. The same principle can be applied to doc- 
umentation as well. Instead of having one set of answers, created internally 
and disseminated to the outside world, you could have instructions created 
by the very customers who use your products. 



Generally, your task is to create the stubs — sample sections that invite visi- 
tors to add content — that get the user-generated documentation started. 
However, keeping that material updated is much more easily done by the cus- 
tomer who uses the product in ways that you might not have predicted. This 
shortens the time between updates to documentation of a product, often 
giving the customer a greater sense of ownership. User-generated documen- 
tation is not perfect for every type of company. When it works, though, it can 
be a powerful tool. 



Shared Spreadsheets 

Until now, spreadsheets have existed only as a document that had to be 
traded to be updated. However, with wikis, a single spreadsheet can be made 
accessible to multiple users at any given time. Instead of copies proliferating 
across individual hard drives and an intranet, the calculations live in one 
place. Every version as well as each change can be viewed or rolled back as 
necessary. TWiki, wikiCalc, and ZippApp all provide the functionality neces- 
sary to create shared spreadsheets. 



Project Management 

At their root, all wikis are project management spaces. The preceding nine 
entries, used together or in different combinations, make up a project man- 
agement toolbox. And unlike project management solutions that you buy off 
the shelf, wikis are flexible and open to almost limitless customization. 
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In This Chapter 

Exploring TiddlyWiki, wetpaint, and Central Desktop 
Sizing up StikiPad, wikiCalc, and WikiTree 
Getting the scoop on WikiTimeScale and Swicki 
Discovering Kwiki and FlexWiki 



The explosion in popularity of wikis has led to a kind of collective breeding 
experiment. Every genetic variation of a wiki is being tested. Here's one 
such fruit fly-like formula: Wikipedia + television = "The TV IV, the online com- 
pendium of television knowledge that anyone can edit" (http : / /tviv . org). 
Dozens of other such oddities exist. Many other variants involve the cross 
breeding of wikis with technologies or programming languages, such as the 
Microsoft Robotics Studio wiki (http : / / channel 9 .msdn . com/wiki/ 
default . aspx/Channel9 .MSRoboticsStudio). 

In this chapter, we introduce you to ten notable wikis. Some represent worthy 
wikis that we just didn't have time or space to cover elsewhere in the book. 
Others are oddities that are fascinating in their own right. They have been 
chosen either because they offer a technological innovation or because they 
present wiki functionality in a pleasing combination that is worthy of attention. 



TiddlyWiki 

www . tiddlywiki . com 

The wikis that grab the most attention today are the big, public ones used by 
millions of people. It's easy to forget that wikis evolved from one man's desire 
to create a killer, personal filing system. TiddlyWiki is, in many ways, a return 
to the roots of wiki. And it's so much fun to use that, after you understand it, 
you won't be able to stop playing with it. 
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TiddlyWiki is a wiki for your personal computer. You access it through a Web 
browser, and it looks just like a Web site. However, TiddlyWiki excels mostly 
hanism for scribbling personal notes (known as Tiddlers) and keep- 
notes organized, hyperlinked, and tagged with keywords. Tiddlers 
are not intended for use with big chunks of content. Even TiddlyWiki's cre- 
ator, Jeremy Ruston, says that it's best suited for MicroContent — fragments 
of text, pictures, or other material that is smaller than a full page. TiddlyWiki 
is good for lots of other things, too. It can 

Replace Stickies or small text files that clutter your desktop 
W Be used as a regularly updated to-do list 

Become a personal glossary or encyclopedia 
i>* Serve as a phone book 

And, last but not least, your TiddlyWiki can be put online and used as a blog 
or personal Web site. Just follow the instructions found in the Help section. 



vOetpaint 



www . wetpaint . com 

wetpaint is a hosted wiki that combines features of wikis, blogs, and forums 
to create rich Web sites quickly and without a lot of technical knowledge. The 
sites created by wetpaint are created from one of 24 different skins, each 
designed by someone who knows what they are doing. (A skin is a template 
that changes the look and feel of a wiki.) Comments can be added to wetpaint 
pages, but individual pages can be locked. Check out http : / /booklust . 
wetpaint . com for an example of what wetpaint can do. wetpaint sites are 
free, but advertisements are placed on the pages. Go to www. wetpaint . com 
to start a site. 



Central Desktop 

www . centraldesktop . com 

Central Desktop takes the spirit of wikis and applies it to the problem of get- 
ting people to work together efficiently in business. The creators of Central 
Desktop use the concepts and mechanisms of wikis, but they fearlessly 
added features and embedded applications for discussions, blogs, file man- 
agers, task lists, milestone management, and calendars. Central Desktop has 
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WYSIWYG (What You See Is What You Get) editing and the ability to control 
page access. Central Desktop is free for limited use, but a variety of subscrip- 
s are available for increased number of users and more disk space. 



www . stikipad . com 



StikiPad is a hosted wiki that offers task lists, discussions, file attachments, 
and innovative features like integration with Google maps and mobile access, 
something that is rarely addressed by other wikis. StikiPad is created by 
using the Ruby language. StikiPad wikis are free, but upgrades provide more 
space, advanced features, and technical support. To create a wiki on StikiPad, 
go to www . stikipad . com. 



urikiCalc 

www . sof twaregarden . com/wkcalpha 

Spreadsheets are among the essential items found on almost every PC. When 
the co-creator of the first electronic spreadsheet (Dan Bricklin) became inter- 
ested in wikis, he immediately applied it to his area of expertise. The result is 
wikiCalc. 

wikiCalc takes the power of a spreadsheet — the ability to format data or text 
and calculate data in a tabular layout — and combines it with the collabora- 
tive flexibility of a wiki. At the time of this writing, wikiCalc is so new that it's 
still in the alpha stage, which means that it's untested and might have bugs 
that still need to be worked out. Don't let that stop you from downloading 
and installing the program, though, which is available for both Mac and 
Windows platforms. wikiCalc can be run locally (on your own hard drive) or 
remotely (you install it on a server and make it accessible to the outside 
world via the Web). If you're a beginner, try running wikiCalc locally at first. 
Just download the application and run the install program to get started. 

wikiCalc is not the only wiki that you can use for creating spreadsheets. 
TWiki (along with several others) lets you create tables that can be edited 
collaboratively online. None of the spreadsheets we have encountered, 
though, are as easy to get up and running as wikiCalc. 
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Another powerful feature of wikiCalc is that you can easily publish your 
spreadsheet online in a variety of ways. When you tell wikiCalc to publish a 
,ieet, it automatically converts the spreadsheet to HTML (the lan- 
;d by Web sites) for you. 



WikiTree 

www . wikitree . org 

Anyone who has put together a family tree will recognize some distinct 
phases to the process: 

i>* Phase One: Sketch out the historical dates of every family member you 
can think of. 

Phase Two: Contact everyone on the list you made in Phase One, ask 
them to fill in the gaps, and see whether they have any details on family 
members who aren't listed. 

Phase Three: Trace family connections to be led to people who you've 
never met before, live in some faraway place, share your last name, and 
just might share your genealogy. 

This enormously rewarding process enhances family bonds but essentially 
takes place in isolation. WikiTree is going to change family research forever. 

WikiTree is an attempt to create a family tree of everyone who has ever lived. 
And it does so by automating the process of creating bloodline trees and 
making them accessible to everyone. Creating a new tree is completely free. 

WikiTree is still in its infancy. Volunteers are hard at work improving the 
graphics and functionality of the entries. If you want to help a budding wiki 
grow, WikiTree is a great place to set down roots. Look for the Treehouse link 
in the left navigation bar to see how to pitch in. 



WikilimeScaie 

www . wikitimescale . org 

The presentation of content can sometimes be as important as the informa- 
tion itself, WikiTimeScale is a case in point: It is a wiki that shows historical 
events through a graphical interface. The default home (shown in Figure 18-1 
page is a graph showing empires, epochs, and great people. Underneath 
the graph is a Zoom feature; go ahead and click +25% to zoom in on the 
graph a bit. 
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©The Graph -Ttie Heart! © Click here and watch iwo movies explaining hew WikiTimeScale works! 



1.May,2.007> 



— Classical antiquity — < 
i Pompeii 

— * Roman Empire Rise and Fall 



1 Chinese Empire ■ 



- Augustus 
—i Jesus of Nazareth 
'■— i Ptolemy 



iijgustine of Hippo — 

» Attila •— 
* Attilas war in the west i 



h Western Roman Empire 



1 Eastern Roman Empire 1 



* Holy Roman Empire ■ 



First Crusade I 
Jfnlnfats TemrilatA 



■ Habsburg dynasty ■ 



You can sort the WikiTimeScale page so that it shows only wars or empires, 
for example, by clicking the More View Options link in the left navigation bar. 
You can also adjust the scale and size of the graph. 

WikiTimeScale is still a stub, with much work to be done before it becomes a 
truly useful tool. (For more on stubs, see Chapter 4.) Right now, for example, 
there are relatively few U.S. Presidents included on the scale (likely because 
the WikiTimeScale project was created by a Dutchman). If you're looking for a 
wiki to make your mark on, this one offers an excellent opportunity. 

WikiTimeScale is also available for personal and private use. You can down- 
load the underlying code for the scale by clicking the Open Source link on the 
navigation bar. 



SiVicki 

http : / /swicki . eurekster . com 

Swicki is a fascinating combination of wikis, search, and community collabo- 
ration intended to improve the way people find information. When you put a 
swiki in your site, a tag cloud interface displays that shows words with font 
sizes based on how popular they were as search terms. This tag cloud is cre- 
ated based on what users of your site are searching for. Then, when search 
results are displayed, user behavior is monitored, and users can vote on 
which search results are most useful. The search results page also allows 
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questions to be asked and answered. Swicki intends to extend personal pub- 
lishing on the Web by allowing anyone to publish a community-powered 
gine that produces only the targeted search results that you and 
munity want. 



Kvliki 

www . kwiki . org 

Kwiki is Perl-based implementation of a wiki, created by Brian Ingerson, that 
is designed to be easily extensible. Pretty much everything in Kwiki is a plug- 
in. (A plug-in is a bit of code to perform a small function that fits neatly in 
with all the other bits of code in a program.) This architecture makes it easy 
to add new functionality to make Kwiki do whatever you want it to do. If you 
have Perl skills and want to explore the possibilities of what wikis can do, go 
directly to www . kwiki . org. 



FlexWiki 

www . f lexwiki . com 

The wiki world was taken by surprise when David Ornstein created FlexWiki, 
based on the Microsoft .NET technology, and released it as part of the com- 
pany's shared source initiative. FlexWiki is unique not only because of its 
foundations in Microsoft but also because it's the only wiki that implements 
the WikiTalk language, which is a descendant of SmallTalk, a pioneering 
object-oriented language. FlexWiki is used on the Microsoft Channel 9 com- 
munity Web site. 
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* (asterisk) in wiki markup, 41, 118 
% attachurl % TWiki variable, 145 
%attachurlpath% TWiki variable, 50 
- (dashes) in wiki markup, 40-41, 120-121 
$ (dollar sign) for variable parameters, 256 
%drawing% TWiki variable, 278 
! (exclamation mark) preventing links, 134 
% (percent signs) enclosing variables, 255 
+ (plus sign) for wiki markup heading 

levels, 40-41, 120-121 
? (question mark) 
creating page by clicking, 45-46, 136 
for links to pages not yet existing, 45, 136 
%SEARCH% variable (TWiki), 259-260 
[ ] (square brackets) 
for categories in MediaWiki, 148 
double, for free linking, 134-135, 140-141 
double, for Wikipedia internal links, 88-89 
single, for Wikipedia named links, 90 
for WikiSpaces links, 110 
I (vertical bar or pipe) in wiki markup, 
122-123, 135 



access control, 27, 249-250 
ActionTrackerPlugin, 279 
administrator role, 23, 225, 228, 289 
advertising onwikis, 115-116 
advocacy wikis, 70-72 
alphabetical taxonomy, 155 
Apache server, 217 

application wikis, 29, 30. See also form- 
based wiki applications 
ArborWiki, 74-75 
assessing wiki requirements 
automation, 196 

number of contributors, 194-195 
number of viewers, 195 



potential size of wiki, 196 

security level, 195 

skill level of users, 194 

system requirements, 215-217 

technical expertise, 197 

for walkabout examples, 203 

yourself as wiki champion, 197 
asterisk (*) in wiki markup, 41, 118 
Atkinson, Bill (HyperCard creator), 24-25 
Atlassian's Confluence wiki, 29, 139, 198 
attaching files to pages 

linking to attachments, 144-145 

uploading attachments, 142-144 

as wiki engine feature, 16 

wiki engine variations for, 141 
%attachurl% TWiki variable, 145 
%attachurlpath% TWiki variable, 50 
attitudes, wiki, 283-286 
attracting users 

advertising, 186 

assisting the wiki, 186-187 

challenges for, 179 

collaboration, promoting, 184-185 

to community wikis, 185-187 

confusing your audience, avoiding, 180 

controversy, avoiding, 182 

educating users, 181, 184 

elevator pitch for, 1 79 

encouraging boldness, 185 

Field of Dreams syndrome, avoiding, 181 

focusing the wiki, 186 

instigating use, 184 

neglecting your wiki, avoiding, 180-181 
to office wikis, 187-188 
overdesigning, avoiding, 182 
overmanaging, avoiding, 182 
removing barriers, 184-185 
seeding your wiki, 183-184, 229 
spamming, avoiding, 181 
suicide missions, avoiding, 182-183 
wiki life cycle, 188-190 
automation, 172, 196. See also templates 
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barriers to wiki use, removing, 184-185 
Baseball Reference Bullpen wiki, 58-59, 

156, 170, 171 
Bellizzi, Dominick (WikiSpaces creator), 104 
BibleWiki, 58, 136-137, 155 
BlackListPlugin, 279 
blogs, wikis versus, 14 
BluWiki hosted wikis, 17, 29 
bold formatting, wiki markup for, 118, 123 
boldness, 185, 284 
brackets. See square brackets ([ ]) 
BrainKeeper wiki, 100, 103 
bread crumbs, 36-37, 47-48, 167 
Bricklin, Dan (wikiCalc creator), 299 
brochureware wikis, 78, 161, 162 
bulletin boards or forums, wikis versus, 14 
bullets 

in HTML versus wiki markup, 15 
wiki markup for, 15, 41, 120, 121-122 
businesses. See office wikis; organizations 
Byers, James (WikiSpaces creator), 104 



CAISI (Client Access to Integrated Services 

Information) wiki, 72 
CalendarPlugin, 279 
camel case. See also WikiWords 

in brand names, 133 

defined, 19, 44 

examples, 44, 132 

question mark after word, 45, 136 

rules for, 133 
canceling edits, 41, 88 
CAS 100B Course at Penn State wiki, 73 
case sensitivity 

of camel case, 44, 132-133 

of Wikipedia links, 89 
Case Western Reserve University Wiki, 155 
categories 

defined, 148 

further information, 149 

tags versus, 149 

using in MediaWiki, 148 

in wiki design, 163-165 



Center for Media and Democracy, 71 
Central Desktop wiki, 100, 103, 298-299 
champion. See wiki champion 
change markups, 227 
change notifications, 16, 248-249 
Change Patrol 

quality control patrol, 288 

rolling back changes, 243-247 

running your own, 243-249 

tracking recent changes, 247-249 

at Wikipedia, 234, 240 
Changes link, 35, 52. See also recently 

changed pages list 
ChartPlugin, 279 
child pages, creating, 48 
citations for Wikipedia, 91 
Claroline Development wiki, 65 
Client Access to Integrated Services 

Information (CAISI) wiki, 72 
clubhouse wikis, 76-77 
collaboration, promoting, 184-185 
Colombo, Sean (CosmeticsWiki creator), 59 
colors in wiki design, 152, 172, 174 
CommentPlugin, 276 
commercial wikis, 27, 28-29. See also 

hosted wikis; wiki engines 
communities of wiki people 

attitudes for, 283-286 

culture created by, 13 

help for wiki engine installation from, 218 

life cycle, 22-23 

overview, 21-22 

roles, 22-23, 287-290 

unfinished content created by, 20, 56 

variety of, 9 

Wikipedia Community Portal, 93 
community wikis 
advertising, 186 
assisting the wiki, 186-187 
clubhouse, 76-77 
defined, 21, 56, 185 
entertainment, 75-76 
focusing, 186 
front page design for, 161 
geographical, 74-75 
hosted, 102-103 
overview, 73-74, 102-103 
starting, 185-187 
technology, 77 
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companies. See office wikis; organizations 
Comprehensive Perl Archive Network 
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Confluence wiki (Atla: 



Jjiki), 221-224 
(Atlassian), 29, 139, 198 
connecting to the Web server, 220-221 
consultant (Internet mechanic), 

211,212-214 
content management systems, 14, 198 
content-focused wikis 
defined, 21, 56 

front page design for, 159, 160 

hobbyist, 60-62 

hosted, 103-104 

hybrids, 56, 65 

overview, 57, 103-104 

reference, 57-60 

section page design for, 162-163 

technical documentation, 64-65 

travel, 62-64 

wiki engines for, 198 
contributing. See editing wiki pages 
contributor role, 23, 228, 288, 289-290 
controversy, 182, 240-242 
CookbookWiki, 61 
CosmeticsWiki, 59-60 
cospire wiki, 100, 104 
CPAN (Comprehensive Perl Archive 

Network), 216 
critic role, 290 

Cunningham, Ward (wiki creator) 
camel case linking created by, 131 
characteristics derived from wiki of. 
generosity of, 11 

invention of wikis by, 9, 11, 25-26 
Portland Pattern Repository of, 11, 26 
vision of, 9 

wiki markup invented by, 26 
wikis named by, 26 
WikiWikiWeb of, 69-70 
Curriki, 72, 73 
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dashes (-) in wiki markup, 40-41, 120-121 
DatabasePlugin, 279 



databases. See also form-based wiki 
applications; structured wikis 
defined, 254 

home page creation, 266 

office wikis for, 293 

with structured wikis, 254 

wikis versus, 13 
dedicated server, 211 
deleting or removing 

canceling edits, 41, 88 

change markups for, 227 

orphan pages, 138 

pruning wikis, 104, 189, 226, 227-228, 231 

rolling back changes, 231-234, 239, 240, 
243-247 
deploying wikis, 188 
designing wikis 

categories for pages, 163-165 

copying effective designs, 153 

Edward Tufte on, 153 

fonts, colors, and images, 152, 172-175 

forms and variables for, 1 72 

four dimensions of design, 151-152 

front page, 159-161 

headers and footers, 166, 167-168 

left-hand navigation, 165, 166-167 

linking in patterns, 157-158 

navigational paths, 159-169 

overdesigning, avoiding, 182 

page naming patterns for, 158-159 

section pages, 162-163 

supporting pages, 169 

taxonomy considerations, 152-157 

templates for, 151, 169-172 

themes for, 173-174 
desktop wikis, 30, 192-193 
development wiki engines, 193 
dictionary wiki, 57 
disaster planning, 250-252 
document mode 

combining with thread mode, 127 

described, 117, 126 

inverted triangle structure of, 128 

other modes compared to, 127-128 

refactoring comments, 128 

using, 128-129 
documentation, wikis for, 295 
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DokuWiki, 28, 37, 198, 207-208 
dollar sign ($) for variable parameters, 256 
.(|>vvI)ltM4.dU*tf tWiki^ngine, 34-35, 

%drawing% TWiki variable, 278 



early adopters of wikis, 16-17, 27-28 
ease-of-use wikis 

defined, 21, 56 

hosted, 102 

overview, 77-78, 102 

personal and family, 78-79 

small business brochure, 78 
easier is better attitude, 284 
eBay Wiki, 66-67 

Eco, Umberto (The Mysterious Flame of 

Queen Loand), 229 
editing wiki pages. See also links; wiki 
markup 

attaching files, 49-51 

canceling edits, 41 

CommentPlugin for, 276 

controlling editing access, 249-250 

creating a page at hosted wikis, 107 

creating a page at PBwiki, 19-20 

creating a page at TWiki, 45-47 

creating a Wikipedia entry, 85 

creating child pages, 48 

ease of, 15 

finding lost or orphan pages, 48-49, 138 

formatting Wikipedia entries, 86-87 

at hosted wikis, 108-109 

HTML formatting and layout, 125-126 

identifying parent pages, 47-48 

links to tools for, 38-39 

modes or patterns for pages, 117, 126-130 

previewing pages, 41 

printing pages, 51 

pruning, 104, 189, 226, 227-228, 231 

renaming pages, 49 

rolling back changes, 231-233, 234 

sandbox pages for practice, 17-19 

saving pages, 41, 118-119 

text mode for, 39-42, 108-109 



tracking versions and changes, 51-53, 
247-249 

TWiki Sandbox pages for practice, 38 

wiki engine requirements, 194-195 

Wikipedia entries, 85-88, 92-93 

WYSIWYG, 42-43, 108, 109, 124 
EditMe.com hosted wiki, 78, 100, 102 
editor role, 22, 228 
EditTablePlugin, 277-278 
educating users, 181, 184, 226, 228, 230-231 
educational wikis, 72-73 
elevator pitch, 179 
e-mail 

address conventions in this book, 2 

"To All," office wikis for reducing, 292-293 

TWiki mailing lists, 218 

wikis versus, 13-14 
Encyclopedia Britannica Online, 82-84, 91 
Encyclopedia Gamia, 62, 170 
ending your wiki, 190 
engineers as early adopters, 16-17, 27-28 
engines. See wiki engines 
enterprise wikis, 29, 100 
entertainment wikis, 75-76 
enthusiasm, as security threat, 242 
erasing. See deleting or removing 
E398 Essentials wiki, 77 
evangelist role, 288 
EvoWiki, 71 
example setting, 285 

exclamation mark (!) preventing links, 134 
Extreme Programming, 25 



family wikis, 78-79 
favicons, 175 

Field of Dreams syndrome, 181 
FlexWiki (Microsoft), 28, 302 
focusing the wiki, 186 
fonts 

in this book, 2 

in wikis, 123, 152 
footers, 166, 168 

formatting content. See editing wiki pages; 
wiki markup 
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form-based wiki applications 

add ing forms to template topics, 270 

r^idwg a4p jipaUsd topic list, 272-273 
I fcr<i t(jr]Jj:ijj|;ffy^ home page, 266 

creating a template topic, 268-269 

defining a form, 266-268 

described, 265 

enabling a form, 268 

HTML form for topic creation, 270-272 

improving the topic list, 273-275 

steps for creating, 265 
forms. See also form-based wiki 
applications 

described, 265 

HTML, for creating pages, 264-265, 270-272 
for populating pages automatically, 172 
standardization benefits of, 272 
for structured wikis, 264-275 

forums or bulletin boards, wikis versus, 14 

founder role, 290 

free linking 
flexibility of , 131 

to other webs and namespaces, 141 
URLs for external links, 139-140 
using, 134-135 
in Wikipedia, 88-90 
between wikis using Interwiki names, 
141, 278 

Frey, Adam (WikiSpaces creator), 104 
front page design, 159-161 
functions, variables as, 256-257 
future of wikis, 30 
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gamers' wiki, 62, 170 

Ganfyd wiki, 67-68 

genealogy wiki, 300 

geographical community wikis, 74-75 

geographical taxonomy, 155 

glossary for large wikis, 189 

Google 

JotSpot purchased by, 2, 17, 254 

wiki use by, 1 , 29 
graphics. See designing wikis; images 
The Greater IBM Connection wiki, 77 
Guru.com site, 213 



headers, 166, 167-168 

headings, wiki markup for, 40-41, 120-121 

HeadlinesPlugin, 279 

help 

for editing Wikipedia pages, 88 

pages on wiki, 230 

for wiki engine installation, 218 

for wiki markup, 120 
hierarchy of wiki pages, 37 
history links in footers, 168 
history of wikis 

commercial products, 28-29 

early adopters, 27-28 

features added by developers, 26-27 

growth within companies, 28 

hosted wikis, 1,17, 29-30, 97 

precursors, 24-25 

Ward Cunningham's invention, 9, 11, 25-26 
hobbyist wikis, 60-62 
horizontal rules, wiki markup for, 41, 121 
hosted wikis. See also specific wikis 

accounts for, 17, 20 

adding images, video, and widgets, 115 
community wikis, 102-103 
content-focused wikis, 103-104 
costs, 99, 100-101 
creating pages, 107 
criteria for choosing, 98-99 
customizing, 99, 113-114 
defined, 97 

development of, 1, 17, 29-30, 97 
directories of wikis on, 79 
ease-of-use wikis, 102 
editing pages, 108-109 
inviting others to, 98, 112-113 
linking pages, 109-110 
monitoring and reporting site for, 100 
overview, 1 7, 209 

page protection with, 99, 106, 110-112 
premium services and advertising, 115-116 
private label option, 99 
process-focused wikis, 103 
recommended, overview of, 100-101 
sandbox pages, 17-19 
setting up with WikiSpaces, 104-107 
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Web information for, 98 

wiki engines handled by, 191, 193 

Wikis For Dummies pages on, 17-18 
hosting your own wiki 

all-in-one providers for, 211-212 

dedicated server for, 211 

hosting providers for, 210 

inside your organization, 211 

Internet mechanic for, 211, 212-214 

shared server for, 211 
HTML (HyperText Markup Language) 

change markups, 227 

conventions in this book, 2 

defined, 15 

formatting and layout using, 125-126 
forms for creating pages, 264-265, 
270-272 

for linking to attachments, 144-145 
for linking to images, 145 
standards, 15 
wiki markup versus, 15 
HyperCard, 24-25 



icons 
favicons, 175 

for formatting Wikipedia entries, 86-87 

in margins of this book, 4 
ImagePlugin, 279 
images 

adding to hosted wiki, 115 

favicons, 175 

inserting (linking to), 141, 145-147 
logos, 175 

TWikiDrawPlugin for, 278-279 

uploading, 143, 145 

in wiki design, 152, 172, 175 
index cards metaphor, 11-13, 25, 34 
index link on wikis, 35 
industrial-strength wiki engines, 193 
information architecture. See taxonomies 
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configure script for, 221-224 
connecting to the Web server, 220-221 
downloading and unpacking binaries, 

219-220 
help for, 218 

system requirements, 215-217 
Intellipedia, 67 

Internet mechanic, 211, 212-214 
Internet Relay Chat QRQ, 218 
Internet resources 

ArborWiki, 74 

Atlassian, 29 

Baseball Reference Bullpen, 58 
BibleWiki, 58, 155 
BrainKeeper wiki, 100, 103 
CAISI wiki, 72 

CAS 100B Course at Penn State wiki, 73 

Case Western Reserve University Wiki, 155 

categories in MediaWiki, 149 

Central Desktop wiki, 100, 103, 298 

Claroline Development wiki, 65 

community hosted wikis, 103 

Confluence wiki, 198 

content-focused hosted wikis, 104 

CookbookWiki, 61 

CosmeticsWiki, 59 

cospirewiki, 100, 104 

Cunningham & Cunningham, Inc., 70 

Curriki, 72 

DokuWiki, 198, 207 

ease-of-use hosted wikis, 102 

eBay Wiki, 66 

EditMe.com hosted wiki, 100, 102 
Encyclopedia Gamia, 62, 170 
E398 Essentials wiki, 77 
EvoWiki, 71 
family wikis, 79 
finding wikis, 79 
FlexWiki, 302 
Ganfyd, 67 

The Greater IBM Connection wiki, 77 
hosted wiki information, 98 
hosted wiki lists, 79 
hosted wiki providers, 100-101 
hosted wiki reporting site, 100 
hosting providers, 210 
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Internet mechanics, 213, 214 

Kwiki, 302 

linking tips and tricks, 135 
Lostpedia, 76 
LyricWiki, 76 

Marvel Database Project, 75 
MediaWiki engine, 198, 207 
MoinMoin wiki, 205 
Mr. Lindsay's Room 15 Wiki, 73 
Nexdo wiki, 101, 103 
PBwiki, 101, 102, 103, 104 
personal wikis, 78 
PokerWiki, 60 

Portland Pattern Repository, 11, 26 

process-focused hosted wikis, 103 

Project Backpack, 70 

SAP Enterprise Services wiki, 64 

seedwiki, 101, 103 

Socialtext wiki, 29, 101, 103, 198 

SourceWatch, 71 

spam prevention, 233 

Star Trek wiki, 76 

StikiPad wiki, 101, 102,299 

SugarCRM Support and Development 

wikis, 65 
SuperHappyDevHouse wiki, 77 
Swiki, 301 
TaxAlmanac, 69 
taxonomy examples, 155 
template information, 172 
Tiddly Wiki, 198, 297 
training information, 230 
TWiki consultants list, 214 
TWiki engine download, 254 
TWiki engine installation help, 218 
TWiki home page, 32, 198, 206 
TWiki Internet mechanic skills list, 214 
TWiki plug-ins page, 279 
TWiki variables list, 258 
Uncyclopedia, 76 
Westwood Schools wiki, 72 
wetpaint wiki, 101, 102, 103, 298 
Wikiawiki, 101, 104 
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Wikidot.com, 101, 102 
WikiMatrix, 98, 199 
Wikinews, 70 

Wikipedia home page, 82, 172 
Wikipedia markup cheat sheet, 120 
Wikiquote, 58 
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WikiSpaces, 101, 102, 103, 104 

WikiTimeScale, 155, 300 

Wikitravel, 63, 155 

WikiTree, 300 

WikiWikiWeb, 69 

Wikocracy, 72 

Wiktionary, 57 

Wookiepedia, 76 

XWiki, 204, 212 
Interwiki prefixes, 140 
InterwikiPlugin, 278 
intranet, replacing with office wiki, 294 
Intuit, TaxAlmanac developed by, 69 
IRC (Internet Relay Chat), 218 
italic format 

in this book, 2 
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JhuWiki, 74 
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JotSpot wiki 

as community wiki, 103 

described, 29 

Google's purchase of, 1,17, 254 
hosted wikis offered by, 17, 100 
as process-focused wiki, 103 
as structured wiki, 254 
WYSIWYG editor, 124 
jumping in wikis, 36, 48, 167 

knowledge management, wikis for, 293 
Kraus, Joe (JotSpot founder), 29 
Kupu WYSIWYG editor, 124 
Kwiki, 302 
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defined, 165 
designing, 166-167 
using, 34-36 
Level 1 to 3 headings, 40-41, 120 
librarian for large wikis, 189 
life cycle 
of wiki people, 22-23 
of wikis, 188-190 
links. See also navigating wiki webs; 
uploading 
camel case for, 19, 44, 45, 131 
changing for renamed pages, 49 
creating free links, 134-135 
creating in text mode, 110 
creating in Wikipedia, 88-90 
creating in WYSIWYG editor, 109-110 
creating pages using, 135-136 
creating WikiWord links, 44-45, 132-133 
designing, 151, 157-158 
to editing tools, 38-39 
external, URLs for, 139-140 
to file attachments, 144-145 
finding lost or orphan pages, 48-49, 138 
in footers, 168 
free linking, 131, 134-135 
in headers, 167 

in HTML versus wiki markup, 15 
to images, 141, 145-147 
index cards metaphor for, 13 
to multimedia, 141, 147 
named, 90 
namespaces for, 132 
to other webs and namespaces, 141 
preventing false WikiWord links, 133-134 
for printable pages, 51 
question mark for pages not yet existing, 
45, 136 

renaming all in web, 138-139 
tips and tricks site, 135 
to unfinished content, 20 
viewing all to a page, 137-138 
wiki markup for, 88-90, 110 



in Wikipedia, 88-90 

between wikis using Interwiki names, 
140, 278 

WikiWords for, 15, 44, 132-134 
Linux, for TWiki, 216 
local navigation, 36 
logging in to TWiki as guest, 39 
logos on wikis, 175 
lost pages, finding, 48-49, 138 
Lostpedia wiki, 76 
Lyric Wiki, 76 
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mailing lists (TWiki), 218 
manager role, 23, 225, 228, 289 
managing wikis 

daily tasks, 236 

kinds of tasks, 226 

large wikis, 189 

monthly tasks, 236-237 

need for, 225 

overmanaging, avoiding, 182 
pruning, 104, 189, 226, 227-228, 231 
refactoring, 128, 233-235 
rolling back changes, 231-233, 234 
spam prevention, 233 
templates for, 234 

training users, 181, 184, 226, 228, 230-231 

weekly tasks, 236 

yearly tasks, 237-238 
markup. See HTML (HyperText Markup 

Language); wiki markup 
Marvel Database Project, 75 
Mayfield, Ross (Socialtext creator), 29 
MediaWiki engine 

categories, 148-149 

for content-focused wikis, 198 

document and thread modes in, 127 

heading markup in, 120 

linking methods, 135 

renaming all links in web, 139 

walkabout, 207 

Wikipedia use of, 32 
medical reference wiki, 67-68 
Microsoft's Flex Wiki, 28, 302 
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MoinMoin wiki, 193, 205 
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named links in Wikipedia, 90 
namespaces 

defined, 34 

linking to others, 141 

for links, 132 

for uploaded files in Wikipedia, 145 
naming pages, 158-159 
navigating wiki webs 

exploring the structure, 33-34 

finding lost or orphan pages, 48-49, 138 

introduction page, 33 

jumping from web to web, 36 

jumping to a page, 36 

local navigation, 36 

overview of webs, 34 

searching, 37-38 

using bread crumbs, 36-37 

using links on the left, 34-36 

wiki for practice with, 32 
navigation scheme. See also links; 
navigating wiki webs 

categorizing pages for, 163-165 

clear, designing for, 151 

defined, 159 

front page design for, 159-161 
headers and footers for, 166, 167-168 
left-hand, designing, 165, 166-167 
section page design for, 162-163 
supporting page design for, 169 

Negroponte, John (intelligence czar), 67 

Nexdo wiki, 101, 103 

notification of changes, 16, 248-249 

numbered lists, wiki markup for, 121-122 

Nupedia, 81 
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for databases, 293 

as intranet replacements, 294 

for knowledge management, 293 

for project management, 295 

promoting, 187-188 

as shared repositories, 292 

for shared spreadsheets, 295 

"To All" e-mail reduced by, 292-293 

for training, 294 

for user documentation, 295 

for Web publishing, 294 
open source software, 11, 17, 27, 192 
operating system for TWiki, 216, 223 
operations and hosting engineer, 289 
organizational chart taxonomy, 155 
organizations. See also office wikis 

becoming wiki-wise, 23-24 

growth of wikis in, 10, 28 

hierarchy and wikis in, 188 

wiki engine choices for, 198 

wiki use by, 1, 23-24, 27-28 
Ornstein, David (FlexWiki creator), 302 
orphan pages, finding, 48-49, 138 
overdesigning, avoiding, 182 
overmanaging, avoiding, 182 



page design. See designing wikis 

pages, defined, 153 

parent pages, identifying, 47-48 

passion, as security threat, 240-242 

PBwiki 
as community wiki, 103 
as content-focused wiki, 104 
creating a page at, 19-20 
directory for uploaded files, 145 
as ease-of-use wiki, 102 
hosted wikis offered by, 17, 29, 101 
inserting images, 145-147 
linking to attachments, 144-145 
uploading attachments, 142-144 
uploading images, 143 
uploading plug-ins, 143 
Wikis For Dummies page, 17, 18, 141 
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percent signs (%) enclosing variables, 255 
Perl language, 216 

c^ngs 

pipe or vertical bar (I) in wiki markup, 

122-123, 135 
plug-ins 
CommentPlugin, 276 
defined, 27 

EditTablePlugin, 277-278 

finding, 279 

InterwikiPlugin, 278 

noteworthy, list of, 279 

SpreadSheetPlugin, 276-277 

TagMePlugin, 149-150, 279 

TWiki configuration for, 224 

TWikiDrawPlugin, 278-279 

uploading in PBwiki, 143 

uses for, 275 

WYSIWYG editors, 124 
plus sign (+) for wiki markup heading 

levels, 40-41, 120-121 
PokerWiki, 60-61 

policy and process contributor role, 289-290 
Portland Pattern Repository, 11, 26 
premium services, 115-116 
previewing 

pages when editing, 41 

Wikipedia edits, 87-88 
printable wiki pages, 16, 51 
private pages, 111, 249 
private wikis, 106, 187 
process-focused wikis 

advocacy, 70-72 

assisting the wiki, 187 

defined, 21, 56 

educational, 72-73 

front page design for, 159, 160 

hosted, 103 

hybrids, 56, 65 

overview, 65, 103 

for project management and 
productivity, 66 

promoting in the office, 187-188 

section page design for, 163 

task-oriented, 66-70 
productivity wikis, 56, 66 
ProductWiki section of Amazon.com, 30 
Project Backpack, 70 



project management, wikis for, 23, 56, 
66, 295 

promoting your wiki. See attracting users 
protected pages, 110-111, 249 
protected wikis 

at hosted wikis, 99, 110-112 

for security, 239 

at WikiSpaces, 106, 110-111 
pruning wikis 

continuous need for, 104 

encouraging, 231 

garden metaphor, 104, 226 

large wikis, 189 

overview, 227-228 
public pages, 111, 249 
public wikis, 106 
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quality control patrol. See Change Patrol 

question mark (?) 
creating page by clicking, 45-46, 136 
for links to pages not yet existing, 45, 136 

quotation database wiki, 58 



Raw View tool, 168 

RCS version control system, 216 

reader role, 22, 287 

really simple syndication (RSS), 14, 294 
recently changed pages list 

as Change Patrol to-do list, 247 

Changes link for, 35, 52 

on TWiki, 35 

using, 52-53 

as wiki characteristic, 15 
refactoring, 128, 233-235 
reference wikis. See also Wikipedia 

Baseball Reference Bullpen, 58-59, 170 

BibleWiki, 58 

CosmeticsWiki, 59-60 

overview, 57 

Wikimedia Foundation for, 58 

Wikiquote, 58 

Wiktionary, 57, 58 
Remember icon, 4 
removing. See deleting or removing 
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renaming 
all links in a web, 138-139 




office wiki as, 292 

for project management, 23 

as wiki characteristic, 15 
requirements for wikis. See assessing wiki 

requirements 
researcher role, 287 
reversion capability, 239 
roles 

contributor, 23, 228, 288 
critic, 290 
editor, 22, 228 
evangelist, 288 
founder, 290 

manager/administrator, 23, 225, 228, 289 

operations and hosting engineer, 289 

policy and process contributor, 289-290 

quality control patrol, 288 

reader/researcher, 22, 287 

wiki champion, 22, 23, 197, 228, 290 

wiki coach, 22, 23 

wiki engine developer, 290 

wiki page describing, 228 
rolling back changes 

overview, 231-233 

as security capability, 239 

steps for, 243-247 

in Wikipedia, 234, 240 
RSS (really simple syndication), 14, 294 
rules 

for camel case, 133 

policy and process contributor role, 
289-290 

wiki attitude, 286 

for Wikipedia contributors, 92-93 
Ruston, Jeremy (TiddlyWiki creator), 298 
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sandboxes 
creating a page at PBwiki, 19-20 
defined, 17, 32 

TWiki.org Sandbox web, 34-35, 38-39, 1 1 



Wikipedia:Sandbox, 85 

on Wikis For Dummies pages, 17-18 
SAP Enterprise Services wiki, 64 
saving 

pages when editing, 41, 118-119 

Wikipedia edits, 88 
scalability of wiki engines, 195 
%SEARCH% variable (TWiki), 259-260 
searching in wiki pages 

box in header for, 167 

finding lost pages, 48-49 

limitations of, 38 

overview, 37-38 

structured wiki capabilities for, 259-260 

as wiki engine feature, 16 

Wikipedia, 82 
section page design, 162-163 
SectionalEditPlugin, 279 
security 

assessing requirements for, 195 

backing up for, 239, 251-252 

Change Patrol for, 240, 243-249, 288 

controlling editing access, 249-250 

enthusiasm as threat to, 242 

evaluating threats, 240-243 

mistakes as threat to, 242-243 

moving your wiki, 252 

need for, 239 

passion as threat to, 240-242 

preparing for disaster, 250-252 

protected wikis for, 239 

reversion capability for, 239 

spam prevention, 233 

against system failure, 243 

three-fold defense, 239 

TWiki configuration for, 223 

against vandalism, 240 
seeding your wiki, 183-184, 229 
seedwiki, 101, 103 
servers 

Apache, 217 

connecting to the Web server, 220-221 
for hosting your own wiki, 211 

shared authorship, 283 

shared repositories, 292 

shared server, 211 

short pages, 136-137 
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s ize of wiki 

E^aguiaJaifca-\MMps, 189 

fmM^p (^(for^y ors. 194-195 

number of pages, 196 

number of viewers, 195 
skill level of users, 194 
skins, 173-174, 298 

small business brochure wikis, 78, 161, 162 
Socialtext wiki, 29, 101, 103, 198 
source code, 192 
SourceWatch wiki, 71 
spam, 181, 233 

special-purpose wiki engines, 193 
Spencer, Graham (JotSpot founder), 29 
spreadsheets 

office wikis for sharing, 295 

SpreadSheetPlugin for, 276-277 

wikiCalc for, 299-300 
square brackets ([ ]) 

for categories in MediaWiki, 148 

double, for free linking, 134-135, 140-141 

double, for Wikipedia internal links, 88-89 

single, for Wikipedia named links, 90 

for WikiSpaces links, 110 
standard pages 

forms and templates for, 272 

for large wikis, 189 
standards, 15-16 
Star Trek wiki, 76 
StikiPad wiki, 101, 102,299 
structured mode. See also structured wikis 

described, 117, 127 

at hosted wikis, 115 

other modes compared to, 127-128 

using, 130 

structured wikis. See also structured mode 
attitude for, 285 
described, 115, 254 

determining amount of structure, 254-255 
forms for, 264-275 
origins of, 253 
plug-ins for, 275-279 
searching, 259-260 
simple example, 254-255 
templates for, 130, 260-265, 268-270 
TWiki for, 198, 254 
variables for, 255-258 
stubs, 136-137 
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sub-wikis, 34 

SugarCRM Support and Development 

wikis, 65 
SuperHappyDevHouse wiki, 77 
supporting page design, 169 
Swiki, 17, 301-302 

system failure, protecting against, 243 
system requirements for wiki engines, 
215-217 
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tables 

EditTablePlugin for, 277-278 

HTML for, 125-126 

markup variations for, 120 

SpreadSheetPlugin for, 276-277 

TWiki markup for, 122 

variations in markup for, 122 
tag clouds. See categories 
TagMePlugin, 149-150, 279 
tags, 149-150. See also categories 
task-oriented wikis 

eBay Wiki, 66-67 

Ganfyd, 67-68 

Intellipedia, 67 

overview, 66 

TaxAlmanac, 69 

Wikinews, 70 

WikiWikiWeb, 69-70 
TaxAlmanac wiki, 69 
taxonomies 

categorizing pages, 163-165 

common types of, 154-157 

defined, 27, 151 

hierarchy of wikis, webs, and pages, 153 

for large wikis, 189 

overview, 152-154 

for pages, 154 

Wikipedia example, 154 
technical documentation wikis, 64-65, 198 
technical expertise 

all-in-one providers for, 212 

assessing requirements for, 197 

Internet mechanic for, 211, 212-214 
Technical Stuff icon, 3, 4 
technology wikis, 77 
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templates. See also form-based wiki 
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aleJtopLg^il^ti^ for, 261 
QOT^^nyl^affilications, 261 

for consistent design, 151 
for content page design, 169-172 
creating new pages from, 262-263 
finding pages created from, 263 
forms as extensions of, 265 
for headers and footers, 166 
at hosted wikis, 114, 170 
HTML forms for, 264-265 
for managing wikis, 234 
for office wikis, 187 
for parts of pages, 171-172 
placeholder content with, 170-171 
standardization benefits of, 272 
for structured wikis, 130, 260-265, 268-270 
topic, adding forms to, 270 
topic, creating, 261-262, 268-269 
Wikipedia article on, 172 
text mode. See also wiki markup 
defined, 40 

editing pages in, 39-42, 108-109 

entering by clicking question mark, 45 

WYSIWYG versus, 43, 124 
TGZ files, 221 
themes, 173-174 
Thoeny, Peter (co-author) 

HTML use by, 125 

structured wikis created by, 253 

survey of wiki-related spam resources, 233 

TWiki created by, 29, 125 

Wind River wiki created by, 29 
thread mode 

combining with document mode, 127 

described, 117, 126-127 

other modes compared to, 127-128 

replacing with document mode, 130 

types of information on pages, 129 

using, 129-130 

as wiki style, 14 
TiddlyWiki, 28, 198, 297-298 
timeline taxonomy, 155 
Tip icon, 4 
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wiki users, 181, 184, 226, 228, 230-231 
travel wikis, 62-64 
TreePlugin, 279 

Tufte, Edward (Yale University professor), 
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TWiki engine. See also installing TWiki 
engine; structured wikis 

for company wikis, 198 

downloading, 34-35, 219-220, 254 

Peter Thoeny as creator of, 29, 125 

system requirements, 215-217 

walkabout, 206-207 
TWikiDrawPlugin, 278-279 
TWiki.org 

attaching files to pages, 49-51, 145 

bread crumbs, 36-37, 47-48 

bullet markup, 41, 121-122 

consultants list at, 214 

creating a page, 45-47 

creating links, 44-45 

editing pages in text mode, 39-42 

editing pages in WYSIWYG mode, 42-43 

guest login, 39 

heading markup, 40-41, 120, 121 

identifying parent pages, 47-48 

Internet mechanic information at, 214 

links on the left, 34-35 

mailing lists, 218 

namespaces, 132 

navigating, 33-38 

plug-ins page, 279 

as practice wiki, 32, 118 

renaming all links in web, 138-139 

Sandbox web, 34-35, 38-39, 118 

searching, 37-38 

stopping WikiWord linking in, 133-134 

structure of, 33 

for structured wikis, 198, 254 

Support Web, 218 

table markup in, 122-123 

tagging in, 149-150 

topics, 35 

WYSIWYG editor, 124 
TwistyPlugin, 279 
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encouraged in wikis, 20, 284 

finding in wikis, 56 

stubs or short pages for, 136-137 
unpacking TWiki binaries, 219-220 
uploading 

file attachments, 142-144 

images, 143, 145 
URLs or Web addresses. See also Internet 
resources 

conventions in this book, 2 

for external links, 139-140 

Interwiki prefixes instead of, 140 

for TWiki configuration, 222 
user documentation, wikis for, 295 
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vandalism, 240 
variables 

defined, 255 

functions, 256-257 

listing online, 258 

parameters for, 256-257 

for populating pages automatically, 172 

syntax for, 255 

table listing, 257-258 

TWiki, 40, 145, 255-258 

wiki markup example, 255-256 
versioning or version control. See also 
rolling back changes 

defined, 16, 27, 51 

for TWiki, 216 

uses for, 51-52 

as wiki engine feature, 16 
vertical bar or pipe (I) in wiki markup, 

122-123, 135 
video, adding to hosted wiki, 115 

wabi-sabi, 20, 284 
walkabout 

DokuWiki, 207-208 

MediaWiki, 207 



MoinMoin wiki, 205 
overview, 202-203 
points to ponder, 204 
TWiki, 206-207 
XWiki, 204-205, 206 
Warning! icon, 4 

Washtenaw County, Michigan wiki, 74-75 
Web addresses. See Internet resources; 

URLs or Web addresses 
Web publishing, 14, 294 
webs 

defined, 33, 34, 153 

linking to others, 141 

namespaces, 34, 132 

overview, 34 

renaming all links in, 138-139 

sub-wikis in, 34 

in taxonomy hierarchy, 153 
Westwood Schools wiki, 72 
wetpaint wiki 

as community wiki, 103 

as ease-of-use wiki, 102 

hosted wikis offered by, 29, 101 

overview, 298 

Wikis For Dummies page, 17 
What You See Is What You Get. See 

WYSIWYG 
widgets, adding to hosted wiki, 115 
wiki champion 

attitudes for, 285, 286 

becoming, 23, 197 

defined, 22, 290 

wiki page describing, 228 
Wiki Choice Wizard (WikiMatrix), 200-201 
wiki coaches, 22, 23 

wiki engines. See also hosted wikis; hosting 
your own wiki; installing TWiki engine 
access control, 249-250 
assessing wiki requirements for, 194-197 
basic categories of, 192-193 
comparing, 197-202 
defined, 11,32, 191 
developers, 289 
development of, 16-17, 28 
help for installing, 218 
at hosted wikis, 191, 193 
namespaces with, 132 
open source roots of, 11, 27, 192 
safe choices (table), 198 
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scalability of, 195 
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2-193 

hoosing, 202-208 
wiki farms. See hosted wikis 
wiki markup 
applying to a page, 1 18-1 19 
for bullets, 15, 41, 120, 121-122 
conventions in this book, 2 
defined, 118 
for formatting text, 123 
for headings, 40-41, 120-121 
help for, 120 

for horizontal rules, 41, 121 

HTML versus, 15 

for links, 88-90, 110 

saving pages after applying, 118-119 

for tables, 122-123 

in text-mode editing, 40-41, 108-109 

variables in, 255-256 

variations in, 120 

as Ward Cunningham's invention, 26 
wiki people. See communities of wiki 

people 
Wikiawiki, 17, 29, 101, 104 
wikiCalc, 299-300 
Wikidot.com, 101, 102 
Wikilndex catalog of wikis, 79 
WikiMatrix Web site, 98, 199-202, 203 
Wikimedia Foundation, 58, 79. See also 

MediaWiki engine; Wikipedia 
Wikinews, 70 

Wikipedia. See also MediaWiki engine 
abortion page, 241-242 
accuracy and reliability issues, 82, 91-92 
Arbitration Committee, 92 
canceling edits, 88 
case sensitivity of links, 
categories, 148-149 
Categories link, 82 
Change Patrol, 234, 240 
citations for, 91 
colors in design of, 172 
Community Portal, 93 
as content-focused wiki, 
document and thread modes in, 127 
Edit Summary box, 87 
edit wars, 92 
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editing entries, 85-88 

Encyclopedia Britannica Online versus, 

82-84, 91 
formatting entries, 86-87 
growth of, 84-85 
heading markup in, 120 
help for editing pages, 88 
home page, 82,83, 172 
linking to a specific section of an entry, 89 
linking to another entry, 88-89 
linking to outside sources, 90 
lists of wikis on, 79 
MediaWiki engine used by, 32 
named links, 90 

namespace for uploaded files, 145 
previewing edits, 87-88 
reasons for success of, 81-82 
as research tool, 90-91 
rolling back changes in, 234 
rules for contributors, 92-93 
run by Wikimedia Foundation, 58 
sandbox, 85 
saving edits, 88 
Search field, 82 
sister projects, 93 
subject areas, 82 
taxonomy of, 154 
templates article, 172 
vandalism of, 240 
volunteers, 84 
Web site, 82 

wiki markup cheat sheet, 120 
Wikiquote, 58, 93 
wikis 

categories of, 21, 56 

challenges for defining, 1 1 

characteristics of, 15 

defined, 2, 11, 13, 15, 153 

future of, 30 

history of, 24-30 

index cards metaphor for, 11-13, 34 

innovations, 16, 27 

life cycle, 188-190 

origin of name, 26, 70 

other communication tools versus, 

13-14, 25 
in taxonomy hierarchy, 153 
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backup options, 251-252 
~^5i^la*tf ilrviiW 74 
|rn|ilij iffygfr 103 

as content-focused wiki, 104 
creation of, 104 
customizing your wiki, 114 
as ease-of-use wiki, 102 
heading markup in, 120 
hosted wikis offered by, 17, 29, 101 
inviting others to your wiki, 112-113 
premium services, 116 
private pages, 111, 249 
private wikis, 106 
protected pages, 110-111, 249 
protected wikis, 106 
public pages, 111, 249 
public wikis, 106 
renaming all links in web, 139 
setting up a wiki, 104-107 
themes, 173-174 
Wikis For Dummies page, 17, 112 
Wikispecies, 93 
WikiTimeScale, 155, 300-301 
Wikitorial, 182, 240 
Wikitravel, 63, 155 
WikiTree, 300 
WikiWikiWeb, 69-70 
WikiWords 
camel case for, 19, 44 
creating links using, 44-45, 132-133 
defined, 133 

enabling on wiki engine, 133 
examples, 44, 132 
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preventing false links, 133-134 

question mark after, 45, 136 

used for links, 15 
Wikocracy, 72 
Wiktionary, 57, 58, 93 
Woods, Dan (co-author) 

hosted wiki reporting site, 100 

wikis as desktop for, 30 
Wookiepedia, 76 

World Wide Web, 25. See also Internet 
resources; URLs or Web addresses 
WYSIWYG (What You See Is What You Get) 
defined, 38 

editing pages in, 42-43, 108, 109 

limitations of, 43, 124 

overview, 124 

plug-in editors, 124 

text mode versus, 43, 124 



•X 



XWiki 

as all-in-one provider, 212 
hosted wikis offered by, 17, 29 
walkabout, 204-205, 206 
Wikis For Dummies page, 17 



Zevola, Nicki (CosmeticsWiki creator), 59 
ZIP files, 221 



